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This reference publication contains 
specifications for the IBM System/ 360 Basic 
Operating System Assembler Language (16K 
Disk/Tape) (including macro instructions and 
conditional assembly facilities). 

The assembler language is a symbolic 
programming language used to write programs for 
the IBM System/360. The language provides a 
convenient means for representing the machine 
insiiructions and related data necessary to program 
the IBM System/360. The IBM System/360 Basic 
Operating System Assembler Program processes the 
language and provides auxiliary functions useful 
in the preparation and documentation of a program, 
and includes facilities for processing macro 
instructions. 

Part 1 of this publication is an introduction 
to the assembler language. 

Part 2 describes the basic functions of the 
assembler language. 

Part 3 describes the conditional assembly and 
macro facilities in the assembler language. 










PREFACE 



edge of System/ 360 machine concepts. The 
publications most tlosely related to this 
one are: 



This publication is a reference manual for 
the programmer using the assembler language 
(including macro instructions). 

Part 1 of this publication presents 
information common to all parts of the 
language. Part 2 contains specific infor- 
mation concerning the symbolic machine 
instruction codes and the assembler program 
functions provided for the programmer's 
use. Part 3 of this publication describes 
the conditional assembly and macro facili- 
ties in the assembler language- 
Appendices A through J follow Part 3. 
Appendices A through F are associated with 
Parts 1 and 2 and present such items as a 
summary chart for constants (Appendix F) , 
instruction listings, character set rep- 
resentations, and other aids to program- 
ming. Appendix G contains macro-facility 
summary charts, and Appendix H discusses 
table capacities for various elements of 
the language. Appendix I is a sample pro- 
gram. Appendix J is a features comparison 
chart of System/360 assemblers. 

Prerequisite for a thorough understand- 
ing of this publication is a basic knowl- 



1. IBM System/360 Principles of Operation , 
Form A22-6821. 

2. IBM System/360 Basic Operating System; 
Data Management Concepts (16K Disk) , 
Form C2 1-3 It 27, or 

IBM Svsteffl/360 Basic Operating System: 
Data Management Concepts (16K Tape) , 
Form C2«»-3430. 

3. IBM System/360 Basic Operating System; 
Supervisor and Input/Output Macros (16K 
Disk ), Form C2'*-3i»29, or 

IBM Sv3tem/36Q Basic Operating System: 
Supervisor and Input/Output Macros (16K 
Tape) , Form C2U-3a32. 

U. IBM System/360 Basic Operating System: 
System Control and System Service Pro- 
grams (16K Disk) . Form C24-3428, or 

IBM System/ 360 Basic Operating System: 
System Control and System Service Pro- 
grams <16K Tape) . Form C2it-3431. 

Titles and abstracts of other related 
jMiblications are listed in the IBM 
Svstem/360 Bibliography , Form A22-6822. 
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PART 1 — INTRODUCTION TO THE ASSEMBLER LANGUAGE 



SECTION 1: INTRODUCTION 



Computer programs may be expressed in 
machine language, i.e., language directly 
interpreted by the computer, or in a syra- 
bolic langxaage, which is much more meaning- 
ful to the programimer. The symbolic lan- 
guage, however, must be translated into 
machine langxaage before the computer can 
execute the program. This function is 
accomplished by an associated processing 
program called an assembler or a compiler. 

Of the various symbolic programming 
languages, assembler languages are closest 
to machine language in form and content. 

The assembler language discussed in this 
manual is a symbolic programming language 
for the IBM System/3 60. It enables the 
programmer to use all IBM System/360 
machine functions, as if he were coding in 
System/360 machine language. 

The assembler program that processes the 
language translates symbolic instructions 
into machine-language instructions,, assigns 
storage locations, and performs auxiliary 
functions necessary to produce an executa- 
ble machine- language program. 



MACHINE FEATURES REQUIRED 

• 16,384 bytes of main storage. At least 
10,240 contiguous bytes must be availa- 
ble to the Assembler. Additional stor- 
age, if available to the Assembler, is 
used to allocate area for expanding 
Assembler tables. 

• Standard instruction set. 



forms only, or 1443)*-, if a printed 
listing is desired. 

• One 1052 Printer-Keyboard 

• One 2311 Disk Storage Drive. This has 
the BOS (16K Disk) resident system 
pack. 



or 



• One 2400-series Magnetic Tape Unit 

(9-track). This has the BOS <16K Tape) 
resident system. 

* Three work files. These can be: 

Three 2311 Disk Storage extents. (Disk 
system only.) These extents may be on 
the same device that contains the BOS 
(16K Disk) resident system; 



or 



Three 2400-series Magnetic Tape Units 
(either 7-track or 9-track: If 
7-track, the data conversion feature is 
required) . These can be used for 
either the disk or tape system- 

The assemble-and-execute option is 
an alternative to the DECK option; both 
are not supported for the same assem- 
bly. If the assemble-and-execute 
option is chosen, SYSOOO is a 
24 00-series Magnetic Tape Unit {9-track 
or 7-track with the data conversion 
feature) for the tape-resident system, 
or a 2311 Disk Storage extent (which 
may be on the system residence device) 
for the disk- resident system. 



• One I/O Channel (either multiplexor or 
selector) 

• One Card Reader (1442N1, 2501, 2520B1, 
or 2540)=»- 

*• A 2400-series Magnetic Tape Unit may 
be substituted for this device. (It 
may be 7-track or 9-track. If 7-track 
is used the data conversion feature is 
required.) The 1052 Printer-Keyboard 
must be operable if device assignment 
is tape. 

• One Card Punch (1442N1, 1442N2, 2520, 
or 2540)^, if punched output is 
desired. 

• One Printer (1403, 1404 - continuous 



COMPATIBILITY 



Within Basic Operating System/360 (16K) , 
the assemblers can be used on System/360 
Models 30, 40, 50, 65, and 75, provided 
that main storage and input/output 
requirements are satisfied. The assemblers 
(16K Disk and 16K Tape) will both accept 
the same source language input and produce 
identical object output. 

The Basic Operating System/360 Assembler 
(16K Disk/Tape) assembles source programs 
written in the System/360 Basic Programming 
Support Basic Assembler Language, the Basic 
Programming Support Assembler (8K Tape) 
Language, the IBM 7090/7094 Support Package 
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for IBM Systein/360 Assembler Language, and 
the Basic Operating System/360 Assembler 
(8K Disk) Language, with the following 
exceptions: 

1. The XFR assembler instruction, which is 
considered an invalid mnemonic opera- 
tion code in Basic Operating System/ 360 
{16K Disk/Tape) is not allowed. 

2. Additional cards may be required in 
macro definitions (if used by the 
source program) to satisfy Basic Oper- 
ating System/360 (16K Disk/Tape) macro 
requirements . 

3. System macro instructions are changed, 
where necessary, to conform with the 
proper Basic Operating System require- 
ments . 



The language is augmented by other sym- 
bols, supplied by the programmer, and used 
to represent storage addresses or data. 
Symbols are easier to remember and code 
than their machine- language equivalents. 
Use of symbols greatly reduces programming 
effort and error. 



Machine Operation Codes 



The assembler language provides mnemonic 
machine-instruction operation codes for all 
machine instructions in the IBM System/360 
Universal Instruction Set, and extended 
mnemonic operation codes for the condi- 
tional branch instruction. 



ti. An MNOTE assembler instruction whose 
operand entry consists solely of a 
message enclosed in apostrophes is 
given a severity code of one. 

5. AIF operand entries must not contain 
explicit boolean zeros or ones. 

The Basic Operating System/360 (16K 
Disk/Tape) assembler language is a subset 
of the Operating System/360 assembler lan- 
guage. Source programs written in Basic 
Operating System/ 360 (16K Disk/Tape) assem- 
bler language will be acceptable to the 
Operating System/ 3 60 assemblers provided 
that system macro instructions are changed, 
where necessary, to conform with the proper 
Operating System requirements. 

Note ; The assignment, size, and order- 
ing of literal pools may differ among the 
assemblers. 



Assembler Operation Codes 



The assembler language also contains 
mnemonic assembler- instruction operation 
codes, used to specify auxiliary functions 
to be performed by the assembler program. 
These are instructions to the assembler 
program itself and, with a few exceptions, 
do not result in the generation of any 
machine-language code by the assembler 
program. Certain assembler instructions, 
i.e., conditional assembly instructions, 
affect the order of source statement assem- 
bly and macro generation or the content of 
generated instructions. 



Macro- Instructions 



Differences in conditional assembly 
instructions for System/360 assemblers are 
described in Section 10 of this publica- 
tion. 



The assembler language enables the program- 
mer to define and use macro instructions. 
Macro instructions are represented by an 
operation code which, in turn, actually 
stands for a sequence of machine and/or 
assembler instructions that accomplish the 
desired function. 



THE ASSEMBLER LANGUAGE 



The basis of the assembler language is a 
collection of mnemonic symbols which rep- 
resent: 

1. System/360 ma chine- language operation 
codes, 

2. Operations (auxiliary functions) to be 
performed by the assembler program. 

3. A sequence of machine and assembler 
operations. 



Macro-instructions used in preparing an 
assembler language source program fall into 
two categories: system macro- instruct ions, 
provided by IBM, which relate the object 
program to components of the Basic Operat- 
ing System, and macro- instructions created 
by the programmer specifically for use in 
the program at hand, or for incorporation 
in a library, available for future use- 
Programmer- created macro- instructions 
are used to simplify the writing of a pro- 
gram and/or to ensure that a standard 
sequence of instructions is used to accom- 
plish a desired function. 



For instance, the logic of a program may 
require the same instruction sequence to be 
executed again and again. Rather than code 
this entire sequence each time it is need- 
ed, the programmer creates a macro- 
instruction to represent the sequence, and 
then each time the sequence is needed, the 
programmer simply codes the macro- 
instruction statement. During assembly, 
the sequence of instructions represented by 
the macro-instruction is insertjed in the 
object program. 

Part 3 of this publication discusses the 
conditional assembly and macro facilities. 



THE ASSEMBLER PROGRAM 



ent of the source program. The assembler 
program furnishes a printed listing of the 
source statements and object prograra state- 
ments and additional information useful to 
the programmer in analyzing his program, 
such as error indications. The object 
program is in the format required by the 
linkage editor component of Basic Operating 
System/ 360. 

The amount of main and secondary storage 
allocated to the assembler program for use 
during processing determines the maximum 
number of certain language elements that 
may be present in the source program. For 
a discussion of these dependencies, see 
Appendix H . 



The assembler program, also referred to as 
the "assembler," processes source 
statements written in the assembler lan- 
guage. The assembler is separated into an 
assembly section and a conditional assembly 
and macro generation section. 



The Macro Generation and Conditional 



Assembly Section 



Before source statements can be translated 
into actual machine language, macro- 
instructions and conditional assembly 
statements within the source program must 
be processed. The source program is read. 
Any programmer macro-definitions which 
appear before the main portion of the pro- 
gram are stored for use when the macro is 
referenced. (System macro-definitions are 
retrieved from the macro library and han- 
dled in the same way.) 

The main portion of the program is then 
processed. Whenever macro generation or 
conditional assembly is required, the gen- 
erated or conditionally assembled text is 
inserted in the original source program. 
The resultant augmented source program is 
ready for input to the assembly section. 



PROGRAMMER AIDS 



The assembler program provides auxiliary 
functions that assist the programmer in 
checking and documenting programs, in con- 
trolling address assignment, in segmenting 
a program, in data and symbol definition, 
in generating macro-instructions, and in 
controlling the assembly program itself. 
Mnemonic codes, specifying these functions, 
are provided in the language. 

Variety in Data Representation; Dec ima 1 , 
binary, hexadecimal, or character represen- 
tation of ma chine- language binary values 
may be employed by the programmer in writ- 
ing source statements. The programmer 
selects the representation best suited to 
his purpose. 

Base Register Address Calculation; As 
discussed in the IBM System/360 Principles 
of Operation manual, the System/360 
addressing scheme requires the designation 
of a base register (containing a base 
address value) and a displacement value in 
specifying a storage location. The assem- 
bler assumes the clerical burden of calcu- 
lating storage addresses in these terms for 
the symbolic addresses used by the program- 
mer. The programmer retains control of 
base register usage and the values entered 
therein. 



The Assembly Section 



Processing a source program involves the 
translation of source statements into 
machine language, the assignment of storage 
locations to instructions and other ele- 
ments of the program, and the performance 
of the auxiliary assembler program func- 
tions designated by the programmer. The 
output of the assembler program is the 
object program , a machine- language equival- 



Relocat ability; The object programs pro- 
duced by the assembler are in a format 
enabling relocation from the originally 
assigned storage area to any other suitable 
area. 

Sectioning and Linking: The assembler 
language and program provide facilities for 
partitioning an assembly into one or more 
parts called control sections . Control 
sections may be added or deleted when load- 
ing the object program. Because control 
sections do not have to be loaded contigu- 
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ously in storage, a sectioned program may 
be loaded and executed even though a con- 
tinuous block of storage large enough to 
accommodate the entire program may not be 
available. 



bier language. Detected errors are indi- 
cated in the program listing. 



The linking facilities of the assembler 
language and program allow symbols to be 
defined in one assembly and referred to in 
another, thus effecting a link between 
separately assembled programs. This per- 
mits reference to data and/or transfer of 
control between programs. A discussion of 
sectioning and linking is in Section 3 
under Program Sectioning and Linking . 

Program Listings; A listing of the source 
program statements and the resulting object 
program statements is produced by the 
assembler for each source program it assem- 
bles. The programmer can partly control 
the form and content of the lis ting - 

Error Indications; As a source program is 
assembled, it is analyzed for actual or 
potential errors in the use of the assem- 



BASIC OPERATING SYSTEM RELATIONSHIPS 



The assembler program is a component of the 
IBM Basic Operating System/360 and, as 
such, functions under control of the Basic 
Operating System. The Basic Operating 
System provides the assembler with 
input/output, library, and other services 
needed in assembling a source program. In 
a like manner, the object program produced 
by the assembler will normally operate 
under control of the Basic Operating System 
and depend on it for input/output and other 
services. In writing the source program, 
the programmer must include statements 
requesting the desired functions from the 
Basic Operating System. (See the Supervi- 
sor and Input/Output Macros publications 
listed in the Preface. ) 
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SECTION 2: GENERAL INFORMATION 



This section presents information about 
assembler language coding conventions, 
assembler source statement structure, 
addressing, and the sectioning and linking 
of programs. 



statement line and, if needed, columns 
16-71 of successive continuation lines. 



ASSEMBLER LANGUAGE CUBING CONVENTIONS 



Continuation Lines 



This subsection discusses the general cod- 
ing conventions associated with use of the 
assembler language. 



Coding Form 



A source program is a sequence of source 
statements that are punched into cards. 
These statements may be written on the 
standard coding form, X28-6509 (Figure 
2-1), provided by IBM. One line of coding 
on the form is punched into one card. The 
vertical columns on the form correspond to 
card columns. 



When it is necessary to continue a state- 
ment on another line the following rules 
apply. 

1. Enter any nonblank character in the 
continuation column of the statement 
line. 

2. Continue the statement on the next line, 

starting in the continue column. 
Columns to the left of the continue 
column must be blank. 

Only one continuation line is allowed 
except for source macro-instructions and 
macro prototype statements, which may have 
more than one continuation line (see Part 
3) . 



Space is provided on the form for pro- 
gram identification and instructions to 
keypunch operators. None of this informa- 
tion is punched into a card. 

The body of the form (Figure 2-1) is 
composed of two fields: the statement 
field, columns 1-71, and the 
identification-sequence field, columns 
73^80. The identification-sequence field 
is not part of a statement and is discussed 
following the subsection Statement Format . 

The entries (i.e., coding) composing a 
statement occupy columns 1-71 of a 



Statement Boundaries 



Source statements are normally contained in 
columns 1-71 of statement lines and columns 
16-71 of any continuation lines. There- 
fore, columns 1, 71, and 16 are referred to 
as the "begin," "end," and "continue" 
columns, respectively. This convention may 
be altered by use of the Input Format Con- 
trol (ICTL) assembler instruction discussed 
later in this publication. 



General Information 
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statement Forroat 



There are two types of 

statements — instructions and comments. 

Instructions may consist of one to four 
entries in the statement field. They are, 
from left to rights a name entry, an 
operation entry, an operand entry, and a 
comments entry. These entries must be 
separated by one or more blanks , and must 
be written in the order stated. 

The coding form (Figure 2-1) is ruled to 
provide an eight-character name field, a 
five-character operation field, and a 
5 6- character operand and/or comments field- 

If desired, the programmer may disregard 
these boundaries and write the name, 
operation, operand, and comment entries in 
other positions, subject to the following 
rules: 

1. The entries must not extend beyond 
statement boundaries (either the con- 
ventional boundaries, or as designated 
by the programmer via the ICTL 
instruction) . 

2. The entries must be in proper sequence, 
as stated above. 

3. The entries must be separated by one or 
more blanks. 

U. If used, a name entry must be written 
starting in the begin column. 

5. The name and operation entries must be 
completed in the first line of the 
statement, including at least one blank 
following the operation entry, 

A description of the name, operation, 
operand, and comments entries follows: 

Name Entries ; The name entry is a symbol 
created by the programmer to identify a 
statement. A name entry is usually option- 
al, but, if present, must be entered with 
the first (or only) character appearing in 
the begin column. If the begin column is 
blank, the assembler program assumes no 
name has been entered. Blanks must not 
appear within a name entry, whether the 
symbol was introduced directly by the pro- 
grammer or indirectly by conditional assem- 
bly or macro generation. 

Ope ra t i on £nt r i es ; The operation entry is 
the mnemonic operation code specifying the 
desired machine operation, macro, or assem- 
bler function. An operation entry is man- 
datory and must appear in the first state- 
ment line, starting at least one position 
to the right of the begin column. Valid 



mnemonic operation codes for machine and 
assembler operations are contained in 
Appendices D and E of this publication. 
Valid operation codes consist of five char- 
acters or less for machine or assembler 
operation codes, and eight characters or 
less for macro- instruction operation codes. 
No blanks may appear within the operation 
entry. 

Operand Entries; Operand entries are the 
coding that identifies and describes data 
to be acted upon by the instruction, by 
indicating such things as storage loca- 
tions, masks, storage- area lengths, or 
types of data. 

Depending on the needs of the instruc- 
tion, one or more operands may be written. 
Operands are required for all machine 
instructions . 

Operands must be separated by commas. 
Blanks must not intervene between operands 
and the commas that separate them. 

The operands may not contain embedded 
blanks except as follows: 

If character representation is 
used to specify a constant, a 
literal, or immediate data in an 
operand, the character string may 
contain blanks, e.g., C*AB D*. 

Comments Entries: Comments are descrijjtive 
items of information about the program that 
are to be inserted in the program listing. 
All valid characters (see Character Set in 
this section), including blanks may be used 
in writing a comment. The entry cannot 
extend beyond the end column (normally 
column 71) , and a blank must separate it 
from the operand. 

In instructions where an operand entry 
is not present but a comments entry is 
desired, the absence of the operand entry 
must be indicated by a comma preceded and 
followed by one or more blanks, as follows: 



I Name | Operation (Operand 

I CSECT I , COMMENT 






L 



I . 

I - 

jEND 

.X 



COMMENT 






Instruction Example: The following example 
illustrates the use of name, operation, 
operand, and comments entries. A compare 
instruction has been named by the symbol 
COMP; the operation entry (CR) is the mne- 
monic operation code for a register-to- 
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register compare operation, and the tvra 
operands (5,6) designate the two general 
registers whose contents are to be 
compared. The comments entry reminds the 
programmer that he is comparing "new sum" 
to "old" with this instruction. 



r T r 1 

I Name [Operation j Operand j 

|COMP |CR I 5,6 NEW SUM TO OLD | 

L ± J J 



Summary of Instruction Format 



There are two types of comments state- 
ments. One type, written with an asterisk 
(♦) in the begin column, is used for com- 
ments on the source program. The other 
type, written with a period in the begin 
column and followed by an asterisk, is used 
for comments on a macro-definition. This 
type is further described in Section 7 . 

An example of the comments statement is: 

I Name | Operation j Operand | j 
^ ± L + ^ 

1 ♦THIS IS A COMMENT STATEMENT WHICH j X j 
I IS CONTINUED ON ANOTHER LINE. | j 



The entries in an instruction must always 
be separated by at least one blank and must 
be in the following order: name, operation, 
operand (s), comment. 

Every statement reguires an operation 
entry. Name and comment entries are 
optional. Operand entries are required for 
all machine instructions and most assembler 
instructions. 

The name and operation entries must be 
completed in the first statement line, 
including at least one blank following the 
operation entry. 

The name and operation entries must not 
contain blanks. Operand entries must not 
have blanks preceding or following the 
commas that separate them. 

A name entry must always start in the 
"begin" column. 

If the column after the end column is 
blank, the next line must start a new 
statement. If the column after the end 
column is not blank, the following line 
will be treated as a continuation line- 
All entries must be contained within the 
designated begin, end, and continue column 
boundaries. 



Comments Statements 



Comments statements are used to include a 
programmer's notes on an assembly listing- 
(These notes can be helpful during debug- 
ging and maintenance of a program. ) Com- 
ments statements have no effect in the 
assembled program; they are only printed in 
the assembly listing and, therefore, may 
appear at any point. Extensive notes, or 
comments, may be written by using a series 
of comments statements. 



Identification-Sequence Field 



The identification- sequence field of the 
coding form (columns 73-80) is used to 
enter program identification and/or state- 
ment sequence characters. The entry is 
optional. If the field, or a portion of 
it, is used for program identification, the 
identification is punched in the statement 
cards, and reproduced in the printed list- 
ing of the source program. 

To aid in keeping source statements in 
order, the programmer may code an ascending 
sequence of characters in this field or a 
portion of it. These characters are 
punched into their respective cards, and, 
during assembly, the programmer may request 
the assembler to verify this sequence by 
use of the Input Sequence Checking ( ISEQ) 
assembler instruction. This instruction is 
discussed in Section 5 under Program Con- 
trol Instructions. 



Character Set 

Source statements are written using the 
following characters: 

Letters A through Z, and $, #, S 

Ciqits through 9 



Special 
Characters + - 



♦ ( ) ' / 6 blank 



These characters are represented by the 
card punch combinations and internal bit 
configurations listed in Appendix A. In 
addition, any of the remainder of the 256 
punch combinations may be designated in a 
character self-defining term, a character 
constant, or a comment. 
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ASSEMBLER LANGUAGE STRUCTURE 



The basic structure of the lang(uage can be 
stated as follows. 

A source statement is coroposed of: 

• A name entry (usually opticfnal) . 

• An operation entry (mandatojry) . 

• An operand entry (usually rtequired). 

• A comments entry (optional), 

A name entry is : 

• A symbol. 

An operation entry is: 

• A mnemonic operation code ife presenting 
a machine, assembler, or m^cro instruc- 
tion. 



Figure 2-2 depicts this structure. 
Terms shown in Figure 2-2 are classed as 
absolute or relocatable. Terms are abso- 
lute or relocatable due to the effect of 
program relocation upon them, (Program 
relocation is the loading of the object 
program into storage locations other than 
those originally assigned by the assembler 
program.) A terra is absolute if its value 
does not change upon relocation. A term is 
relocatable if its value changes upon relo- 
cation. 

The following subsection. Terms and 
Expressions , discusses these items as out- 
lined in Figure 2-2. 



TERMS AND EXPRESSIONS 



An operand entry is: 

• One or more operands composed of one or 
more expressions, which, in turn, are 
composed of a term or an aifithmetic 
combination of terms. In general, an 
operand entry should contain 50 or 
fewer terms (see Appendix ri) . 

Operands of machine instructions gener- 
ally represent such things as storage loca- 
tions, general registers, immeciiate data, 
or constant values. Operands ti>f assembler 
instructions provide the inf oritiation needed 
by the assembler program to perform the 
designated operation. 



TERMS 



Every term represents a value. This value 
may be assigned by the assembler program 
(symbols, symbol length attribute, location 
counter reference) or may be inherent in 
the term itself (self- defining term, 
literal) . 

An arithmetic combination of terms is 
reduced to a single value by the assembler 
program. 

The following material discusses each 
type of term and the rules for its use. 
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Name Entry 



Operation Entry 



Is a Symbol 
which is an 



Is a Mnemonic 
Operation Code 



A/achine 
Instruction 



Ordinary 
Symbol (RT) 



Variable 
Symbol 



Sequence 
Symbol 



A Symbol 
e.g., BETA 
(AT or RT) 



Assembler 
Instruction 



Macro 
Instruction 



Term 



which may be 
any one of 
the following 



A Self- 
defining 
Term (AT) 



A Location 
Counter Refer- 
ence i.e., * 
(RT) 



Exp 



Operand Entry 



One or more 
Operands that 
ore composed 
of an 



A Literal 
e.g., = F'1259" 
(RT) 



Symbol Length 
Attribute Refer- 
ence e.g., 
L 'Symbol (AT) 



Exp (Exp) 



Exp (Exp, Exp) 



Exp - Expression 



Arithmetic 
Combination 
of Terms 



Decimal 
e.g., 15 



which may be 
any one of 
the following 



Hexadecimal 
e.g.,X'C4' 



Binary 
e.g.,B'10r 



Character 

e.g.,C'AB9' 



AT = Absolute Term 
RT = Relocatable Term 



Figure 2-2. Assembler Language Structure — Machine and Assembler Instructions 
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Symbols 



A symbol is a character or combination of 
characters used to represent locations or 
arbitrary values. Symbols, through their 
use in name fields and in operands, provide 
the programmer with an efficient way to 
name and reference a program element. 
There are three types of symbols: 

1, Ordinary symbols. 

2, Variable symbols. 

3, Sequence symbols. 

Ordinary symbols consist of one to eight 
letters and/or numbers, the first of which 
must be a letter. Such symbols are used to 
identify machine locations or arbitrary 
values. In the following sections, the 
occurrence of symbol refers to this type of 
term. Absolute symbols are ordinary sym- 
bols whose values do not change upon pro- 
gram relocation. Relocatable symbols are 
ordinary symbols whose values change upon 
relocation. 

The following are valid ordinary sym- 
bols: 

READER 

A23456 

XUF2 

LOOP2 

N 

S4 

aB4 

$A1 

#56 

The following ordinairy symbols are 
invalid, for the reasons noted: 

256B First character is not 

alphabetic. 

RECORDAREA2 More than eight characters. 

BCD* 3 4 Contains a special character 
- an asterisk. 

IN AREA Contains a blank. 

Variable symbols consist of an ampersand 
(6) followed by one to seven letters and/ or 
numbers, the first of which must be a let- 
ter. Variable symbols are used within the 
source program or macro definition to allow 
different values to be assigned to one 
symbol. A complete discussion of variable 
symbols appears in Part 3 . 

Sequence symbols consist of a period <•) 
followed by one to seven letters and/or 
numbers, the first of which must be a let- 
ter. Sequence symtsols are used to indicate 
the position of statements within the 
source program or nacro definition. 



Through their use the programmer can vary 
the sequence in which statements are proc- 
essed by the assembler program. (See the 
complete discussion in Part 3 ) . 

DEFINING SYMBOLS: During the macro genera- 
tion and conditional assembly process, 
variable symbols, sequence symbols, and 
relevant ordinary symbols appearing outside 
macro definitions in source text are col- 
lected and entered into one of several 
dictionaries. These symbols are defined at 
this time exclusively for use in the macro 
generation and conditional assembly sec- 
tion. 

The assembly section maintains an inter- 
nal table: the symbol table, in which sym- 
bols from the augmented source program are 
kept with their basic attributes. A symbol 
^^ defined , i.e., entered into the symbol 
table, when it appears as the name of a 
source statement (after macro generation). 
(A special case of symbol definition is 
discussed in Section 3 , in the subsection 
Program Sectioning and Linking . ) When the 
assembler program encounters a symbol in an 
operand, it refers to the table for the 
attributes associated with the symbol. 

Every symbol has three basic attributes: 
value, length, and relocatability. (Others 
are discussed in Section 9 ). The value 
attribute is the arbitrary value or the 
address of the storage location represented 
by the symbol. 

The length attribute is the length in 
bytes of the storage field represented by 
the symbol, or one for arbitrary values. 
For example, a symbol naming an instruction 
that occupies four bytes of storage has a 
length attribute of U. However, when a 
symbol has been defined by an equate to a 
location counter value (EQU to ♦) or to a 
self-defining term, the length attribute of 
the symbol is 1. 

When the assembler encounters a new 
control section, it assigns a number to the 
section. The relocatability attribute of a 
relocatable symbol is the number of the 
control section in which the symbol is used 
as a name entry. The relocatability attri- 
bute of an absolute symbol is zero. 

The values assigned to symbols naming 
storage areas, instructions, constants, and 
control sections represent the addresses of 
the leftmost bytes of the storage fields 
containing the named items. Since the 
addresses of these items may change upon 
program relocation, the symbols naming them 
are considered relocatable . 

A symbol used as a name entry in the 
equate symbol (EQU) assembler instruction 
is assigned the value designated in the 
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operand entry of the instruction. Since 
the operand entry may represent a relocata- 
ble value or an absolute (i.e., 
nonchanging) value, the symbol is consid- 
ered a relocatable term or an absolute term 
depending upon the value to which it is 
equated. 

The value of a symbol may not be nega- 
tive and may not exceed 2^**-!. 

PREVIOUSLY DEFINED SYMBOLS: The assembler 
language requires that symbols appearing in 
the operand entry of some instructions be 
previously defined. This simply means that 
the symbols, before their use in an oper- 
and, must have appeared as the name entry 
of a prior statement. For example: 



SYMl 
SYM2 



MVC 
EQU 



A, B 
SYMl 



binary value or bit configuration they 
represent. 

Self- defining terms are classed as abso- 
lute terms because the values they rep- 
resent do not change upon program reloca- 
tion. 

USING SELF-DEFINING TERMS: Self-defining 
terms are the means of specifying machine 
values or bit configurations without equat- 
ing the values to symbols and using the 
symbols. Self- defining terms may be used 
to specify such program elements as immedi- 
ate data, masks, registers, addresses, and 
address increments. 

The use of a self-defining term is quite 
distinct from the use of data constants or 
literals. When a self-defining term is 
used in a machine-instruction statement, 
its value is assembled into the instruc- 
tion. When a data constant or literal is 
specified in the operand of an instruction, 
its address is assembled into the instruc- 
tion. 



would be a valid sequence of coding. The 
same two instructions in reverse order 
would be invalid. 

GENERAL RESTRICTIONS ON SYMBOLS: A symbol 
may be defined only once in an assembly. 
While the same symbol may appear as the 
name of two or more statements before macro 
generation and conditional assembly, only 
one such statement should be generated. In 
addition, a symbol may be used in the name 
field more than once as a control section 
name (i.e., defined in the START, CSECT, or 
DSECT assembler statements described in 
Section 3 ) because the coding of a control 
section may be suspended and then resumed 
at any subsequent point. The CSECT or 
DSECT statement that resumes the section 
must be named by the same symbol that ini- 
tially named the section; thus, the symbol 
that names the section must be repeated. 
Such usage is not considered to be duplica- 
tion of a symbol definition. 



Self-Defining Terms 



Decimal Self-Defining Term; A decimal term 
is simply an unsigned decimal number writ- 
ten as a sequence of decimal digits- High- 
order zeros may be used (e.g., 007). 
Limitations on the value of the term depend 
on its use. For example, a decimal term 
that designates a general register must 
have a value between and 15 inclusively; 
one that represents an address must not 
exceed the size of storage. In any case, a 
decimal term may not consist of more than 
eight digits or exceed 16,777,215 (2^'*-l). 
A decimal term is assembled as its binary 
equivalent. Some examples of decimal self- 
defining terms are: 8, 147, 4092, 00021. 

Hexadecimal Self-defining Term: A 
hexadecimal self-defining term is an 
unsigned hexadecimal number written as a 
sequence of hexadecimal digits- The digits 
must be enclosed in single apostrophes and 
preceded by the letter X: X'ca9'. 

Each hexadecimal digit is assembled as 
its four- bit binary equivalent. Thus, a 
hexadecimal term used to represent an 
eight- bit mask would consist of two hexa- 
decimal digits. The maximum value of a 
hexadecimal term is X'FFFFFF'. 



A self-defining term is one whose value is 
inherent in the term. It is not assigned a 
value by the assembler program. For exam- 
ple, the decimal self- defining term — 15 
— represents a value of fifteen. 

There are four types of self-defining 
terms: decimal, hexadecimal, binary, and 
character. Use of these terms is spoken of 
as decimal, hexadecimal, binary, or charac- 
ter representation of the machine language 



The hexadecimal digits and their bit 
patterns are as follows: 

0- 0000 4- 0100 8- 1000 C- 1100 

1- 0001 5- 0101 9- 1001 D- 1101 

2- 0010 6- 0110 A- 1010 E- 1110 

3- 0011 7- 0111 B- 1011 F- 1111 

A table for converting from hexadecimal 
representation to decimal representation is 
provided in Appendix B - 



Binary Self-Defining Term: A binary self- 
defining term is written as an unsigned 
sequence of l*s and O's enclosed in 
apostrophes and preceded by the letter B, 
as follows: B'lOOOllOl*. This terra would 
appear in storage as shown, occupying one 
byte. A binary term may have up to 2U bits 
represented. Padding with binary zeros is 
on the left. 



Binary representation is used primarily 
in designating bit patterns of masks or in 
logical operations. 



The following example illustrates a 
binary term used as a iiask in a Test Under 
Mask (TM) instruction. The contents of 
GAMMA are to be tested, bit by bit, against 
the pattern of bits represented by the 
binary term. 



I Name | Operation [Operand | 

y 1 1 ^ 

I ALPHA |TM I GAMMA, B' 10101101' j 

L J.„ ._X ^ . J 



Character Self- Cef ining Term: A character 
self-defining term consists of one to three 
characters enclosed by apostrophes. It 
must be preceded by the letter C. All 
letters, decimal digits, and special char- 
acters may be used in a character term. In 
addition, any of the remainder of the 256 
punch combinations may be designated in a 
character self-defining term. Examples of 
character self -defining terms are as fol- 
lows: 



CV 

C • ABC • 



C* • (blank) 
C'13' 



Because of the use of apostrophes in the 
assembler language and ampersands in the 
macro language as syntactic characters, the 
following rule must be observed when using 
these characters in a character term. 

For each apostrophe or ampersand desired 
in a character term, two apostrophes or 
ampersands must be written. For example, 
the character value; A'# would be written as 
C*A''#', while an apostrophe followed by a 
blank and another apostrophe would be writ- 
ten as C • • • • '. 

Each character in the character sequence 
is assembled as its eight-bit code equiva- 
lent (see Appendix A ). The two apostrophes 
or ampersands that must be used to rep- 
resent a single apostrophe or ampersand 
within the character sequence are assembled 
as a single apostrophe or ampersand. 



Location Counter Reference 



A Location Counter is used to assign 
storage addresses to program statements. 
It is the assembler program's equivalent of 
the instruction counter in the computer. 
As each machine instruction or data area is 
assembled, the Location Counter is first 
adjusted to the proper boundary for the 
item, if adjustment is necessary, and then 
incremented by the length of the assembled 
item. Thus, it always points to the next 
available location. If the statement is 
named by a symbol, the value attribute of 
the symbol is the value of the Location 
Counter after boundary adjustment, but 
before addition of the length. 

The assembler maintains a Location 
Counter for each control section of the 
program and manipulates each Location 
Counter as previously described. Source 
statements for each section are assigned 
addresses from the Location Counter for 
that section. The Location Counter for 
each successively declared control section 
assigns locations in consecutively higher 
areas of storage. If a program has multi- 
ple control sections, all statements iden- 
tified as belonging to the first control 
section will be assigned from the Location 
Counter for section i, the statements for 
the second control section will be assigned 
from the Location Counter for section 2, 
etc. This procedure is followed whether 
the statements from different control sec- 
tions are interspersed or written in con- 
trol section sequence. 

The Location Counter setting can be 
controlled by using the START and ORG 
assembler instructions, which are described 
in Sections 3 and 5, respectively. The 
counter affected by either of these assem- 
bler instructions is the counter for the 
control section in which they appear. The 
maximum value for the Location Counter is 
22'*-l. 

The programmer may refer to the current 
value of the Location Counter at any place 
in a program, by using an asterisk in an 
operand. The asterisk represents the loca- 
tion of the first byte of currently availa- 
ble storage (i.e., after any required 
boundary adjustment). Using an asterisk in 
a machine-instruction statement is the same 
as placing a symbol in the name field of 
the statement and then using that symbol as 
an operand of the statement. Because a 
Location Counter is maintained for each 
control section, a Location Counter ref- 
erence designates the Location Counter for 
the section in which the reference appears. 

A reference to the Location Counter may 
be made in a literal address constant 
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(i.e., the asterisk may be used in an 
address constant specified in literal 
form) . The address of the instruction 
containing the literal is used for the 
value of the Location Counter. A Location 
Counter reference nnay not be used in a 
statement which requires the use of a 
predefined symbol, with the exception of 
the EQU and ORG assembler instructions. 



Literals 



A literal term is one of three basic ways 
to introduce data into a program. It is 
simply a constant preceded by an equal sign 
(=) . 

A literal represents data rather than a 
reference to data. The appearance of a 
literal in a source statement directs the 
assembler program to assemble the data 
specified by the literal, store this data 
in a "literal pool", and place the value 
(address) of the storage field containing 
the data in the operand field of the assem- 
bled statement. 

Literals provide a means of entering 
constants (such as numbers for calculation, 
addresses, indexing factors, or words or 
phrases for printing out a message) into a 
program by specifying the constant in the 
operand of the instruction in which it is 
used. This is in contrast to using the DC 
assembler instruction to enter the data 
into the program, and then using the name 
of the DC instruction in the operand. Only 
one reference to a literal is allowed in a 
machine-instruction statement, 

A literal term may not be combined with 
any other terras, 

A literal may not be used as the receiv- 
ing field of an instruction that modifies 
storage. 

A literal may not be specified in an 
address constant (see Section 5, DC — Define 
Constant ) . 

A literal may not have an explicit base 
or an explicit index when specified in an 
instruction. 

The instruction coded below shows one 
use of a literal. 



r -T T 1 

I name \ Operation | Operand | 

). 1 + ^ 

IGAMMA |L |10,=F*274' | 

I J. X J 



The statement GAMMA is a load instruc- 
tion using a literal as the second operand. 
When assembled, the second operand of the 
instruction will be the address at which 
the binary value represented by F'274' is 
stored . 

In general, literals may be used wherev- 
er a storage address is permitted as an 
operand. They may not, however, be used in 
any assembler instruction. Literals are 
considered relocatable, because the address 
of the literal, rather than the literal 
itself, will be assembled in the statement 
that employs a literal. The assembler 
generates the literals, collects them, and 
places them in a specific area of storage, 
as explained in the subsection "The Literal 
Pool." A literal is not to be confused 
with the immediate data in an SI instruc- 
tion. Immediate data is assembled into the 
instruction. 



Literal Format; The assembler requires a 
description of the type of literal being 
specified as well as the literal itself. 
This descriptive information assists the 
assembler in assembling the literal cor- 
rectly. The descriptive portion of the 
literal must indicate the format in which 
the constant is to be assembled. It may 
also specify the length the constant is to 
occupy. 

The method of describing and specifying 
a constant as a literal is nearly identical 
to the method of specifying it in the oper- 
and of a DC assembler instruction. The 
major difference is that the literal must 
start with an equal sign (=), which indi- 
cates to the assembler that a literal fol- 
lows. See the discussion of the DC assem- 
bler instruction operand format ( Section 5 ) 
for the means of specifying a literal. The 
type of literal designated in an instruc- 
tion is not checked for correspondence with 
the operation code of the instruction. 

Some examples of literals are: 



=A(BETA) 
=F*123U* 

=C • ABC • 



address constant literal, 
a fixed- point number with 
a length of four bytes, 
a character literal. 



The Literal Pool; The literals processed 
by the assembler are collected and placed 
in a special area called the literal pool, 
and the location of the literal, rather 
than the literal itself, is assembled in 
the statement employing a literal. The 
positioning of the literal pool may be 
controlled by the programmer, if he so 
desires. Unless otherwise specified, the 
literal pool is placed at the end of the 
first control section. 
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The programmer may also specify that 
multiple literal pools be created. Howev- 
er, the sequence in which literals are 
ordered within the pool is controlled by 
the assembler. Further information on 
positioning the literal pool(s) is in Sec- 
tion 5 under LTORG— BEGIN LITERAL POOL. 



jName {operation | Operand j 

|A1 IDS |CL8 j 

)B2 |DC |CL2*AB* 1 

JHIORD JMVC |A1(L*B2),B2 \ 

jLOORD JMVC 1 A1+L'A1-L'B2(L*B2) ,B2 1 

t^ L L J 



Duplicate Literals ; If duplicate literals 
occur within one literal pool, only one 
literal is stored. Literals are considered 
duplicates only if their specifications are 
identical. A literal will be stored, even 
if it appears to duplicate another literal, 
if it is an A-type address constant con- 
taining any reference to the Location 
Counter. 



The following examples illustrate the 
foregoing rules: 



X'FO* 
C*0' 
XL3 ' • 
HL3 • • 
A(**4) 
A(*+4) 
X*FFFF' 
XVFFFF' 



Both are stored 



Both are stored 



Both are stored 



Identical; the first is stored 



Al names a storage field eight bytes in 
length and is assigned a length attribute 
of eight. B2 names a character constant 
two bytes in length and is assigned a 
length attribute of two. The statement 
named HIORD moves the contents of 82 into 
the leftmost two bytes of Al. The term 
L* B2 in parentheses provides the length 
specification required by the instruction. 
When the instruction is assembled, the 
length is placed in the proper field of the 
machine instruction. 

The statement named LOORD moves the 
contents of B2 into the rightmost two bytes 
of Al- The combination of terms 
Al-»-L'Al-L'B2 results in the addition of the 
length of Al to the beginning address of 
Al, and the subtraction of the length of B2 
from this value. The result is the address 
of the seventh byte in field Al. The con- 
stant represented by B2 is moved into Al 
starting at this address. L'B2 in 
parentheses provides length specification 
as in HIORD. 

Note : The length attribute of * is equal 
to the length of the instruction in which 
it appears, except in an EQU to ♦ instruc- 
tion where the length attribute is 1. 



Symbol Length Attribute Reference 



EXPRESSIONS 



The length attribute of a symbol may be 
used as a term by coding L' followed by the 
symbol, as in: 



L'BETA 

The length attribute of BETA will be 
substituted for the term. The following 
example illustrates the use of L' symbol in 
moving a character constant into either the 
high-order or low-order end of a storage 
field. 

For ease in following the example, the 
length attributes of Al and B2 are men- 
tioned- However, keep in mind that the 
L' symbol term makes coding such as this 
possible in situations where lengths are 
unknown. 



Expressions, which are used in coding oper- 
and entries for assembler language state- 
ments, are composed of either a single term 
or an arithmetic combination of terms (see 
Figure 2-2). Arithmetically combined 
ternis, enclosed in parentheses, may be used 
in combination with terras outside the 
parentheses. For example: 

14+ BETA- (GAMMA- LAMBDA) 

When terms in parentheses are encoun- 
tered in combination with other terms, like 
(GAMMA- LAMBDA) in the example, the paren- 
thesized terms are reduced first to a sin- 
gle value. This value may be absolute or 
relocatable, depending on the combination 
of terms- This value then is used in 
reducing the rest of the combination to 
another single value. 
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Parenthesized terras may be included 
within another set of terms in parentheses. 
For example: 

A+B-(C+D-(E+F)+10) 

This expression has two levels of 
parentheses. A level of parentheses is a 
left parenthesis and its matching right 
parenthesis. One level of parentheses 
surrounds E+F. The next higher level of 
parentheses surrounds C+D- (E+F) +10. The 
innermost set of terms in parentheses (the 
lowest level) is evaluated first. 

The following are examples of valid 
expressions: 



AREAl +X • 2D • 
♦ + 32 
N-25 

FIELD+332 
FIELD 

(EXIT-ENTRY+1) +GO 
=F'123a' 

ALPHA-BETA/ (10+AREA*L' FIELD) 
A* (A* (A* (A+1) +3* (B-3) ) ) 



BETA* 10 

B'lOl' 

C • ABC • 

29 

L' FIELD 

LAMBDA+GAMMA 

TEN/TWO 



5. 



Every expression is computed to 32 
bits. 

Division always yields an integer 
result; any fractional portion of the 
result is dropped. E.g., 1/2*10 yields 
a zero result, whereas 10*1/2 yields 5. 

Division by zero is valid and yields a 
zero result. 



■100 



Parenthesized expressions used in an 
expression are processed before the rest of 
the terms in the expression, e.g., in the 
expression A+BETA* (CON-10) , the term CON-10 
is evaluated first and the resulting value 
used in computing the final value of the 
expression. 

Final values of expressions may never be 
greater than 2^'*-l; however, intermediate 
results may have a maximum value of 2 3i-i. 



Absolute and Relocatable Expressions 



The rules for coding expressions are: 

1. An expression may not start with an 
arithmetic operator, that is, +-/♦ 
Therefore, the expression -A+BETA is 
invalid- However, the expression 

0- A+BETA is valid. 

2. An expression may not contain two terms 
or two operators in succession. 

3. An expression may not consist of more 
than 8 terms. 

^. An expression iray not have more than 
three levels of parentheses. 

5. A multi-term expression may not contain 
a literal. 



An expression is called absolute if its 
value is unaffected by program relocation. 

An expression is called relocatable if 
its value changes upon program relocation. 

The two types of expressions, absolute 
and relocatable, take on these charac- 
teristics from the term or termei composing 
them. The following material discusses 
this relationship. 



Absolute Expression; 
sion may be an absolut 
me tic combination of a 
absolute term may be a 
any of the self-defini 
length attribute refer 
in Figure 2-2, all ari 
are permitted between 



An absolute expres- 
e term or any arith- 
bsolute terms. An 
n absolute symbol, 
ng terms, or the 
ence. As indicated 
thrat?tic operations 
absolute terms. 



Evaluation of Expressions 



A single term expression, e.g., 29, BETA, 
♦, L' SYMBOL, takes on the value of the term 
involved. 

A multi-term expression, e.g. , BETA+10, 
ENTRY-EXIT, 25+10+A/B, is reduced to a 
single value, as follows: 

1. Each term is given its value. 

2. Arithmetic operations are performed 
left to right. Multiplication and 
division are done before addition and 
subtraction, e.g. , A+B+C is evaluated 
as A+(B*C), not (A+B)*C. The computed 
result is the value of the expression. 



An absolute expression may contain relo- 
catable terms (RT) — alone or in combina- 
tion with absolute terms (AT) -- under the 
following conditions: 

1. There must be an even number of reloca- 
table terms in the expression. 



2. The relocatable te 
Each pair of terms 
relocatability att 
appear in the same 
this assembly (see 
and Linking , " Sect 
must consist of te 
signs. The paired 
be contiguous, e.g 



rms must be paired. 

m.ust have the same 
ribute, i.e., they 

control section in 
Program Sectioning 
ion 3) . Each pair 
rms with opposite 

terms do not have to 
., RT+AT~HT. 



3. No relocatable expression may enter 
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into a multiply or divide operation. 
Thus, RT-RT*10 is invalid. However, 
(RT-RT)*10 is valid. 

The pairing of relocatable terms (with 
opposite signs and the same relocatability 
attribute) cancels the effect of reloca- 
tion. Therefore the value represented by 
the paired terms remains constant, regard- 
less of program relocation. For example, 
in the absolute expression A-Y+X, A is an 
absolute term, and X and Y are relocatable 
terms with the same relocatability attri- 
bute. If A equals 50, Y equals 25, and X 
equals 10, the value of the expression 
would be 35. If X and Y are relocated by a 
factor of 100 their values would then be 
125 and 110. However, the expression would 
still evaluate as 35 {50-125+110=35). 

An absolute expression reduces to a 
single absolute value. 

The following examples illustrate abso- 
lute expressions, A is an absolute term; X 
and Y are relocatable terms with the same 
relocatability attribute. 

A-Y+X 

A 

A* A 

X-Y+A 

♦-Y (a reference to the Location Counter 
must be paired with another relocata- 
ble term from the same control sec- 
tion, i.e., with the same relocatabil- 
ity attribute) 

Relocatable Expressions: A relocatable 
expression is one whose value would change 
by n if the program in which it appears is 
relocated n bytes away from its originally 
assigned area of storage. All relocatable 
expressions must have a positive value. 

A relocatable expression may be a relo- 
catable term- A relocatable expression may 
contain relocatable terms — alone or in 
combination with absolute terms — under 
the following conditions: 



14. 



5. 



There must be an odd numiber of reloca- 
table terms. 



All the relocatable terms but one must 
be paired. Pairing is described in 
Absolute Expression . 

The unpaired term must not be directly 
preceded by a minus sign. 

No relocatable term may enter into a 
multiply or divide operation. 

A relocatable expression must have a 
positive value. 



A relocatable expression reduces to a 
single relocatable value. This value is 
the value of the odd relocatable term, 
adjusted by the values represented by the 
absolute terms and/or paired relocatable 
terms associated with it. 

For example, in the expression W-X+w-10, 
W and X are relocatable terms with the same 
relocatability attribute. If initially W 
equals 10 and X equals 5, the value of the 
expression is 5. However, upon relocation 
this value will change. If a relocation 
factor of 100 is applied, the value of the 
expression is 105. Note that the value of 
the paired terms, W-X, remains constant at 
5 regardless of relocation. Thus, the new 
value of the expression, 105, is the result 
of the value of the odd term (W) adjusted 
by the values of W-X and 10. 

The following examples illustrate relo- 
catable expressions. A is an absolute 
term, W and X are relocatable terms with 
the same relocatability attribute, Y is a 
relocatable term with a different relocat- 
ability attribute. 



Y-32*A W-X+* 
W-X+Y 

* (reference to 
Location Counter) 



=F'123ii' (literal) 

A+A+W-W+Y 

W-X+W 

Y 
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PART 2 — BASIC FUNCTIONS OF THE ASSEMBLER LANGUAGE 



SECTION 3; ADDRESSING — PROGRAM SECTIONING 
AND LINKING 



BASE REGISTER INSTRUCTIONS 



ADDRESSING 



The Systeni/360 addressing technique 
requires the use of a base register, which 
contains the base address, and a displace- 
ment, which is added to the contents of the 
base register. The programmer may specify 
a symbolic address and request the assem- 
bler to determine its storage address in 
terms of a base register and a displace- 
ment. The programmer may rely on the 
assembler to perform this service for him 
by indicating which general registers are 
available for assignment and what values 
the assembler may assume each contains. 
The programmer may use as many or as few 
registers for this purpose as he desires. 
The only requirements are that, at the 
point of reference, a register containing 
an address from the same control section is 
available, and that this address is less 
than or equal to the address of the item to 
which the reference is being made. The 
difference between the two addresses may 
not exceed 4 095 bytes. 



ADDRESSES — EXPLICIT AND IMPLIED 



An address is composed of a displacement 
plus the contents of a base register. (In 
the case of RX instructions, the contents 
of an index register are also used to der- 
ive the address.) 



The USING and DROP assembler instructions 
enable programmers to use expressions rep- 
resenting implied addresses as operands of 
machine-instruction statements, leaving the 
assignment of base registers and the calcu- 
lation of displacements to the assembler. 



In order to use symbols in the operand 
field of machine-instruction statements, 
the programmer must (1 ) indicate to the 
assembler, by means of a USING statement, 
that one or more general registers are 
available for use as base registers, (2) 
specify, by means of the USING statement, 
what value each base register contains, and 
(3) load each base register with the value 
he has specified for it. 



A program usually has at least one USING 
statement for each control section to be 
implicitly addressed. 



Having the assembler determine base 
registers and displacements relieves the 
programmer of separating each address into 
a displacement value and a base address 
value. This feature of the assembler will 
eliminate a likely source of programming 
errors, thus reducing the time required to 
check out programs. To take advantage of 
this feature, the programmer uses the USING 
and DROP instructions described in this 
subsection. The principal discussion of 
this feature follows the description of 
both instructions. 



The programmer writes an explicit 
address by specifying the displacement and 
the base register number. In designating 
explicit addresses a base register may not 
be combined with a relocatable symbol. 



He writes an implied address by speci- 
fying an absolute or relocatable address. 
The assembler has the facility to select a 
base register and compute a displacement, 
thereby generating an explicit address from 
an implied address, provided that it has 
been informed (1) what base registers are 
available to it and (2) what each contains. 
The programmer conveys this information to 
the assembler through the USING and DROP 
assembler instructions. 



USING — Use Base Address Register 



The USING instruction indicates that one or 
more general registers are available for 
use as base registers. This instruction 
also assigns the base address values that 
the assembler may assume will be in the 
registers at object time. Note that a 
USING instruction does not load the reg- 
isters specified. It is the programmer's 
responsibility to see that the specified 
base address values are placed into the 
registers. Suggested loading methods are 
described in the subsection Programming 
with the USING Instruction . The typical 
form of the USING instruction statement is: 



2H 



I Name [Operation j Operand | 

I Not I USING I From 2-17 expressions! 

I used I I of the form v,rl, | 

1 I |r2,r3....,rl6 | 



, J X. 



Operand v must be an absolxite or reloca- 
table expression with a value ranging from 
-22** to +23'»-l. No literals are permitted. 
Operand v specifies a value that the assem- 
bler can use as a bcise address,. The other 
operands must be absolute expressions. The 
operand rl specifies the general register 
that can be assumed to contain the base 
address represented by operand v. Operands 
r2, r3, rU, ... specify registers that 
can be assumed to contain v+4096, v+8192, 
v+12288, , . ., respectively. The values 
of the operands rl, r2, r3, ..., rl6 must 
be between and 15 « For example, the 
statement: 



specified, it must be operand rl. In this 
case, the assembler assumes that register 
contains the value zero. Subsequent reg- 
isters specified in the same statement are 
assumed to have the values 4096, 8192, etc. 
The assembler therefore places all subse- 
quent effective addresses less than U096 in 
the displacement field and uses zero for 
the base register field. 

Note; If register is made available by a 
USING instruction, the program is not relo- 
catable, despite the fact that the value 
specified by operand v must be relocatable. 
However, the programmer is able to make the 
program relocatable at some future time by: 

1. Replacing register in the USING 
statement. 

2. Loading the register with a relocatable 
value. 

3. Reassembling the program. 



r — T T 1 

I Name | Operation | Operand | 

j. + .+ ^ 

I I USING I*, 12, 13 I 

L X X J 



tells the assembler it may assume that the 
current value of the Location Counter will 
be in general register 12 at object time, 
and that the current value of the Location 
Counter, incremented by 4096, will be in 
general register 13 at object time. 

If the programmer changes the value in a 
base register currently being used, and 
wishes the assembler to compute displace- 
ment from this value, the assembler must be 
told the new value by means of another 
USING statement. In the following sequence 
the assembler first assumes that the value 
of ALPHA is in register 9. The second 
statement then causes the assembler to 
assume that ALPHA+1000 is the value in 
register 9. 



r T r ' T 

) Name | Operation | Operand ) 

I I USING I ALPHA, 9 | 



DROP — Drop Base Register 



The DROP instruction specifies a previously 
available register that may no longer be 
used as a base register- The typical form 
of the DROP instruction statement is as 
follows : 



r *T 

I Name | Operation 



f 

I Not 
I used 



DROP 



I Operand 
-+ 



I Up to 16 absolute 
I expressions of the 
I form rl,r2, 
|r3, . . . ,rl6 
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I I USING I ALPHA+1000, 9 



I I 






The expressions indicate general reg- 
isters previously specified in a USING 
statement that are now unavailable for base 
addressing. The following statement, for 
example, prevents the assembler from using 
registers 7 and 11: 



I Name j Operation (operand ) 

J. + 1 ^ 

I DROP j 7 , 11 j 

L X J J 



A USING Statement may specify general 
register as a base register if operand v 
is a relocatable expression from any con- 
trol section in the program or an absolute 
value of zero. If general register is 



It is not necessary to use a DROP state- 
ment when the base address in a register is 
changed by a USING statement; nor are DROP 
statements needed at the end of the source 
program. 
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A register made unavailable by a DROP 
instruction can be made available again by 
a subsequent USING instruction. 



PROGRAMMING WITH THE USING INSTRUCTION 



The USING (and DROP) instructions may be 
used anywhere in a program, as often as 
needed, to indicate the general registers 
that are available for use as base reg- 
isters and the base address values the 
assembler may assume each contains at ex- 
ecution time, whenever an address is spec- 
ified in a machine- instruction statement, 
the assembler determines whether there is 
an available register containing a suitable 
base address. A register is considered 
available for a relocatable address if it 
was assigned a relocatable value that is in 
the same control section as the address. A 
register assigned an absolute value is 
available for addressing absolute locations 
only. In either case, the base address is 
considered suitable only if it is less than 
or equal to the address of the item to 
which the reference is made- The differ- 
ence between the two addresses may not 
exceed 4095 bytes. In calculating the base 
register to be used, the assembler always 
uses the available register giving the 
smallest displacement. If there are two 
registers with the same value, the highest 
numbered register is used. 



Name j Operation [Operand 




In the preceding sequence, the BALR 
instruction loads register 2 with the 
address of the first storage location 
immediately following. In this case, it is 
the address of the instruction named FIRST. 
The USING instruction indicates to the 
assembler that register 2 contains this 
location. When employing this method, the 
USING instruction must immediately follow 
the BALR instruction. No other USING or 
load instructions are required if the loca- 
tion named LAST is within 4095 bytes of 
FIRST. 



In Figure 3-1, the BALR and LM instruc- 
tions load registers 2-5. The USING 
instruction indicates to the assembler that 
these registers are available as base reg- 
isters for addressing a maximtim of 16,3 84 
consecutive bytes of storage, beginning 
with the location named HERE. The number 
of addressable bytes may be increased or 
decreased by altering the number of reg- 
isters designated by the USING and LM 
instructions and the number of address 
constants specified in the DC instruction. 



RELATIVE ADDRESSING 



Relative addressing is the technique of 
addressing instructions and data areas by 
designating their location in relation to 
the Location Counter or to some symbolic 
location. This type of addressing is 
always in bytes, never in bits, words, or 
instructions. Thus, the expression ++4 
specifies an address that is four bytes 
greater than the current value of the Loca- 
tion Counter. In the sequence of instruc- 
tions shown in the following example, the 
location of the CR machine instruction can 
be expressed in two ways, ALPHA+2 or 
BETA- 4, because all of the mnemonics in the 
example are for 2-byte instructions in the 
RR format- 



|Name | Operation j Operand 

BEGIN I BALR 

I USING 
HERE 1 LM 

IB 

I DC 



BASEADDR 
FIRST 



LAST 



END 



|2,0 

I HERE, 2, 3, 4, 5 

13, 5, BASEADDR 

I FIRST 

|A(HERE+4 096,HERE+819 2,HERE+12288> 



BEGIN 



Figure 3-1. Multiple Base Register Assignment 
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I Name j Operation 

I ALPHA I LR 

I |CR 

I i BCR 

I BETA I AR 



j Operand 
4 

|3,ti 
I 2, 3 



X. 



PROGRAM SECTIONING AND LINKING 



It is often convenient, or necessary, to 
write a large program in sections. The 
sections may be assembled separately, then 
combined subsequently into one object pro- 
gram. The assembler provides facilities 
for creating multisectioned programs and 
symbolically linking separately assembled 
programs or program sections. The combined 
number of control sections and dummy sec- 
tions plus the number of unique symbols in 
EXTRN statements and V-type address con- 
stants may not exceed 255. (EXTRN state- 
ments are discussed in this section; V-type 
constants in Section 5 under the DC — 
Define Constant assembler instruction.) If 
the same symbol appears in a V-type address 
constant and in the name field of a CSECT 
or DSECT statement, it is counted as two 
symbols. 



Sectioning a program is optional j, and 
many programs can best be written without 
sectioning them. The programmer writing an 
unsectioned program need not concern him- 
self with the subsequent disciission of 
program sections, which are called control 
sections. He need not employ the CSECT 
instruction, which is used to identify the 
control sections of a multisection program. 
Similarly, he need not concern himself with 
the discussion of symbolic linkages if his 
program neither requires a linkage to nor 
receives a linkage from another program. 
He may, however, wish to identify the pro- 
gram and/or specify a tentative starting 
location for it, both of which may be done 
by using the START instruction. He may 
also want to employ the dummy section fea- 
ture obtained by using the DSECT instruc- 
tion. 



Note; Program sectioning and linking is 
closely related to the specification of 
base registers for each control section. 
Sectioning and linking examples are provid- 
ed under the heading Addressing External 
Control, Sections. 



CONTROL SECTIONS 



The concept of program sectioning is a 
consideration at coding time, assembly 
time, and load time. To the programmer, a 
program is a logical unit. He may want to 
divide it into sections called control 
sections; if so, he writes it in such a way 
that control passes properly from one sec- 
tion to another regardless of the relative 
physical position of the sections in stor- 
age. A control section is a block of cod- 
ing that can be relocated, independently of 
other coding, at load time without altering 
or impairing the operating logic of the 
program. It is normally identified by the 
CSECT instruction. However, if it is 
desired to specify a tentative starting 
location, the START instruction may be used 
to identify the first control section. 



To the assembler, there is no such thing 
as a program; instead, there is an assem- 
bly, which consists of one or more control 
sections. (However, the terms assembly and 
program are often used interchangeably. ) 
An unsectioned program is treated as a 
single control section. To the linkage 
editor, there are no programs, only control 
sections that must be fashioned into an 
object program. 



The output of the assembler consists of 
the assembled control sections and a con- 
trol dictionary. The control dictionary 
contains information the linkage editor 
needs in order to complete cross- 
referencing between control sections, as it 
combines them into an object program. The 
linkage editor can take control sections 
from various assemblies and combine them 
properly with the help of the corresponding 
control dictionaries. Successful 
combination of separately assembled control 
sections depends on the techniques used to 
provide symbolic linkages between the con- 
trol sections. 



Whether the programmer writes an unsec- 
tioned program, a multisection program, or 
part of a multisection program, he still 
knows what eventually will be entered into 
storage, because he has described storage 
symbolically. He may not know where each 
section appears in storage, but he does 
know what storage contains. There is no 
constant relationship between control sec- 
tions. Thus, knowing the location of one 
control section does not make another con- 
trol section addressable by relative 
addressing techniques- 
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Control Section Location Assiqninent 



Control section contents can be intermixed 
because the assembler provides a Location 
Counter for each control section. Control 
sections are assigned starting locations 
consecutively, in the same order as the 
control sections first occur in the pro- 
gram. Each control section subsequent to 
the first begins at the next available 
double- word boundary. 



FIRST CONTROL SECTION 



The first control section of a program has 
the following special properties. 

1. The initial value of its location coun- 
ter may be specified as an absolute 
value. 

2. It normally contains the literals 
requested in the program, although 
their positioning can be altered. This 
is further explained under the discus- 
sion of the LTORG assembler instruc- 
tion. 



section first identified by the START. 
Similarly, an unnamed CSECT that occurs in 
a program initiated by an unnamed START is 
considered to identify the continuation of 
the unnamed control section. 

The symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the con- 
trol section. It has a length attribute of 
one. 

The assembler uses the self-defining 
term specified by the operand as the ini- 
tial value of the location counter of the 
program. This value should be divisible by 
eight. For example, either of the follow- 
ing statements: 



r T T 1 

j Name | Operation j Operand | 

^ 1 ^ _^ 

|PR0G2 I START | 20a0 | 

IPR0G2 I START |X'7F8' j 

L J Jl J 

could be used to assign the name PROG 2 to 
the first control section and to indicate 
an initial assembly location of 20U0. If 
the operand is omitted, the assembler sets 
the initial value of the location counter 
to zero. 



START — Start Assembly 



The START instruction may be used to give a 
name to the first (or only) control section 
of a program. There may be only one START 
instruction in an assembly. It may also be 
used to specify the initial value of the 
location counter for the first control 
section of the program. The typical form 
of the START instruction statement is as 
follows: 



r ^ T r 1 

I Name (Operation | Operand | 

j._-„ 1 + ^ 

I A symbol | START |A self-defining | 
I or not I I term or not j 

[used I I used j 

L L J J 

If a symbol names the START instruction, 
the symbol is established as the name of 
the control section. If not, the control 
section is considered to be unnamed. All 
subsequent statements are assembled as part 
of that control section. This continues 
until a CSECT instruction identifying a 
different control section or a DSECT 
instruction is encountered, A CSECT 
instruction named by the same symbol that 
names a START instruction is considered to 
identify the continuation of the control 



Note ; The START instruction may not be 
preceded by any type of assembler language 
statement that may either affect or depend 
upon the setting of the Location Counter. 



CSECT — Identify Control Section 



The CSECT instruction identifies the begin- 
ning or the continuation of a control sec- 
tion. The typical form of the CSECT 
instruction statement is as follows: 



r T T 1 

I Name [Operation (Operand | 

|. + + ^ 

I A symbol | CSECT | Not used; must | 
I or not I I not be present | 

I used I I I 

L X X J 

If a symbol names the CSECT instruction, 
the symbol is established as the name of 
the control section; otherwise the section 
is considered to be unnamed. All state- 
ments following the CSECT are assembled as 
part of that control section until a state- 
ment identifying a different control sec- 
tion is encountered (i.e., another CSECT or 
a DSECT instruction) - 
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The symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the con- 
trol section. It has a length attribute of 
one. 

Several CSECT statements with the same 
name may appear within a program. The 
first is considered to identify the begin- 
ning of the control section; the rest iden- 
tify the resumption of the section. Thus, 
statements from different control sections 
may be interspersed. They are properly 
assembled (assigned contiguous storage 
locations) as long as the statements from 
the various control sections are identified 
by the appropriate CSECT instructions. 



Unnamed Control Section 



If neither a named CSECT instruction nor 
START instruction appears at the beginning 
of the program, the assembler detennines 
that it is to assemble an unnamed control 
section as the first (or only) control 
section. There may be only one unnamed 
control section in a program. If one is 
initiated and is then followed by a named 
control section, any subsequent unnamed 
CSECT statements are considered to resxime 
the unnamed control section. If it is 
desired to write a small program that is 
unsectioned, the program does not need to 
contain a CSECT instruction. 



DSECT — Identify Dummy Sectio^ 



A dummy section represents a 
tion that is assembled but is 
the object program. A dummy 
convenient means of describing 
of an area of storage without 
reserving the storage- (It is 
the storage is reserved either 
other part of this assembly or 
another assembly. ) The DSECT 
identifies the beginning or re 
dummy section. More than one 
may be defined per assembly, 
be named. The typical form of 
instruction statement is as 



1 r T- 

I ^3ame [Operation j Operand 

I A symbol | DSECT |Not 
I I I not be 

I X x_ 



used 



control see- 
not part of 
section is a 
the layout 
actually 
assumed that 
by some 
else by 
instruction 
sumption of a 
dummy section 
but each must 
the DSECT 



follows: 



must 
present 



The symbol in the ncune field is a valid 
relocatable symbol whose value represents 
the first byte of the section. It has a 
length attribute of one. 

Program statements belonging to duimny 
sections may be interspersed throughout the 
program or may be written as a unit. In 
either case, the appropriate DSECT instruc- 
tion should precede each set of statements. 
When multiple DSECT instructions with the 
same name are encountered, the first is 
considered to initiate the dummy section 
and the rest to continue it. 

Symbols that name statements in a dummy 
section may be used in USING instructions. 
Therefore, they may be used in program 
elements (e.g., machine-instructions and 
data definitions) that specify storage 
addresses. An example illustrating the use 
of a dummy section appears subsequently 
under "Addressing Dummy Sections." 

Note 1 ; A symbol that names a statement 
in a dummy section may be used in an A-type 
address constant only if it is paired with 
another symbol (with the opposite sign) 
from the same dummy section. 

Note 2 : A LTORG instruction may not 
appear in a dummy section. 



DUMMY SECTION LOCATION ASSIGNMENT: A Loca- 
tion Counter is used to determine the rela- 
tive locations of named program elements in 
a dummy section. The Location Counter is 
always set to zero at the beginning of the 
dummy section, and the location values 
assigned to symbols that name statements in 
the dummy section are relative to the ini- 
tial statement in the section. 

ADDRESSING DUMMY SECTIONS; The programmer 
may wish to describe the format of an area 
whose storage location will not be deter- 
mined until the program is executed. He 
can describe the format of the area in a 
dummy section, and he can use symbols 
defined in the dummy section as the oper- 
ands of machine instructions. To effect 
references to the storage area, he does the 
following: 

1. Provides a USING statement specifying 
both a general register that the assem- 
bler can assign to the machine- 
instructions as a base register and a 
value from the dummy section that the 
assembler may assume the register con- 
tains. 

2. Ensures that the same register is load- 
ed with the actual address of the stor- 
age area. 

The values assigned to symbols defined 
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in a dummy section are relative to the 
initial statement of the section. 



Thus, all machine- instructions which 
refer to names defined in the dummy section 
will, at execution time, refer to storage 
locations relative to the address loaded 
into the register. 



An example is shown in the following 
coding. Assume that two independent assem- 
blies (assembly 1 and assembly 2) have been 
loaded and are to be executed as a single 
overall program. Assembly 1 is an input 
routine that places a record in a specified 
area of storage, places the address of the 
input area containing the record in general 
register 3, and branches to assembly 2. 
Assembly 2 processes the record. The cod- 
ing shown in the example is from assembly 
2. 



The input area is described in assembly 
2 by the DSECT control section named INAR- 
EA. Portions of the input area (i.e., 
record) that the programmer wishes to work 
with are named in the DSECT control section 
as shown. The assembler instruction USING 
INAREA,3 designates general register 3 as 
the base register to be used in addressing 
the DSECT control section, and that general 
register 3 is assumed to contain the 
address of INAREA. 



Assembly 1, during execution, loads the 
actual beginning address of the input area 
in general register 3. Because the symbols 
used in the DSECT section are defined rela- 
tive to the initial statement in the sec- 
tion, the address values they represent, 
will, at the time of program execution, be 
the actual storage locations of the input 
area. 



iName 

f 

1 ASMBLY2 


[Operation 
1 CSECT 


i Operand 
1 


] 


1 BEGIN 


|BALR 


|2,0 






1 USING 
i . 


1 






1 . 
1 USING 


1 

1 INAREA, 3 






|CLI 


|INCODE,C'A* 






|BE 
1 . 


1 ATYPE 
1 




lATYPE 


1 . 
|MVC 


1 

1 WORKA, INPUTA 






|MVC 
1 . 


1 WORKB, INPUTS 
1 




1 WORKA 


1 . 

IDS 


1 
|CL2 




1 WORKB 


IDS 
1 • 


|CL18 
1 




1 INAREA 


I . 
1 DSECT 


1 
1 




JINCODE 


IDS 


1 CLl 




1 INPUTA 


IDS 


ICL2 




1 INPUTS 


IDS 

1 . 
|END 


|CL18 

1 
1 




L 


._J 


_ i. 


J 



COM — DEFINE BLANK COMMON CONTROL SECTION 



The COM assembler instruction identifies 
and reserves a common area of storage that 
may be referred to by independent assem- 
blies that have been linked and loaded for 
execution as one overall program. 

Only one blank common control section 
may be designated in an assembly. However, 
more than one COM statement may appear 
within a program. The first identifies the 
beginning of the control section; the rest 
identify the resumption of the section. 

When several assemblies are loaded, each 
designating a common control section, the 
amount of storage reserved is equal to the 
longest common control section. The form 
is: 



I Name [Operation j Operand j 

I Not I COM I Not used; must not j 
I used I I be present | 



The common area may be broken up into 
subfields through use of the DS and DC 
assembler instructions. Names of subfields 
are defined relative to the beginning of 
the common section, as in the DSECT control 
section. 
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No instructions or constants appearing 
in a common control section are assembled. 
Data can only be placed in a common control 
section through execution of the program. 

Note ; A LTORG instruction may not appear 



in blank common. 



location 



a!>S( 



If the assignment of common 
done in the same manner by eaclji 
assembly, reference to a 
by any assembly results in the 
tion being referenced. When 
blank common location ass 
zero. 



SYMBOLIC LINKAGES 



storage is 
independent 
in common 
same loca- 
embled, 
ignmeht starts at 



symbol does not have to be identified by an 
EXTRN statement. The V-type address con- 
stant is intended to be used for external 
branch references (i.e., for effecting 
branches to other programs). Therefore, it 
should not be used for external data ref- 
erences (i.e. , for referring to data in 
other programs). 



ENTRY — IDENTIFY ENTRY- POINT Sy^5BOL 



The ENTRY instruction identifies linkage 
symbols that are defined in this program 
but may be used by some other program. The 
typical form of the ENTRY instruction 
statement is as follows: 



Symbols may be defined in one 
referred to in another, thus 
symbolic linkages between 
assembled programs,. The lin 
effected only if the assembler 
provide information about the 
bols to the linkage editor, 
these linkage references at 
assembler places the necessary 
in the control dictionary on 
the linkage symbols identified 
and EXTRN instructions. Note 
symbolic linkages are descr 
between independent assemblies 
cifically, they are linkages 
pendently assembled control 



tie 



ibed 



sectxons. 



In the program where the linkage symbol 
is defined (i.e., used as a name), it must 
also be identified to the Linkage Editor by 
means of the ENTRY assembler instruction. 
It is identified as a symbol that names an 
entry point, which means that another pro- 
gram may use that symbol in order to effect 
a branch operation or a data reference. 
The assembler places this infojrmation in 
the control dictionary. 



program and 
effecting 
independently 
kages can be 
is able to 
Linkage sym- 
which resolves 
lo^d time. The 
information 

basis of 
by the ENTRY 
that these 
as linkages 
more spe- 
bbtween inde- 



uses a sym- 
ram must 



Similarly, the program that 
bol defined in some other prog 
identify it by the EXTRN assembler instruc- 
tion. Since the definition of the symbol 
appears in another program, the assembler 
arbitrarily assigns a length of 1 and a 
value of 0. The assembler places this 
information in the control dictionary and 
the symbol table. 

Another way to obtain symbolic linkages, 
is by using the V-type address constant. 
The subsection "Data Definition 
Instructions" in Section 5 conta 
details pertinent to writing a 
address constant. It is suffic 
note that this constant may be 
an indirect linkage point. It 
from an externally defined synjbol 



ins the 
V-type 
lent here to 
considered 
is created 
but that 



I Name 

Not 
used 



j Operation | Operand 

ENTRY jone or more reloca- 
I table symbols, 
) separated by 
I commas, that also 
i appear as state- 
jment names 



— 1 

1 



J 



A program may contain a maximum of 100 
ENTRY symbols. ENTRY symbols which are not 
defined (not appearing as statement names), 
although invalid, will also count towards 
this maximum. 

An ENTRY statement operand may contain a 
symbol defined in an unnamed control sec- 
tion but may not contain a symbol defined 
in a dummy section or blank common. The 
following example identifies the statements 
named SINE and COSINE as entry points to 
the program. 



r T r 1 

jName | Operation | Operand \ 

) I ENTRY I SINE, COSINE | 

t_ L L I 

Note ; The name of a control section does 
not have to be identified by an ENTRY 
instruction when another program uses it as 
an entry point. The assembler automat- 
ically places information on control sec- 
tion names in the control dictionary. 



EXTRN — IDENTIFY EXTERNAL SY^©OL 



The EXTRN instruction identifies linkage 
symbols that are used by this program but 
defined in some other program. Each exter- 
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nal symbol must be identified; this 
includes symbols that name control sec- 
tions. The typical form of the EXTRN 
instruction statement is as follows: 



JNaroe | Operation | Operand | 

I Not I EXTRN jone or more symbols, j 
I used I I separated by commas J 



The symbols in the operand field may not 
appear as names of statements in this pro- 
gram. The following example identifies 
three external symbols that have been used 
as operands in this program but are defined 
in some other program. 



JName | Operation j Operand j 

J. -(. + ^ 

I I EXTRN jRATEBL,PAYCALC | 
I I EXTRN JWITHCALC j 

L J. a. J 



An example that employs the EXTRN 
instruction appears subsequently under 
"Addressing External Control Sections." 

Note 1 ; A V-type address constant does 
not have to be identified by an EXTRN 
statement. 



jName [Operation ) Operand 

MAINPROG jCSECT | 

BEGIN jBALR j2,0 

i USING I*, 2 



VCON 



IBALR 



[DC 
END 



j 3, VCON 



VCSINE) 

BEGIN 



L— 



For example, to link to the control 
section named SINE, the preceding coding 
might be used. 

An external symbol naming data may be 
referred to as follows : 

1, Identify the external symbol with the 
EXTRN instruction, and create an 
address constant from the symbol. 

2. Load the constant into a general reg- 
ister, and use the register for base 
addressing. 

For example, to use an area named 
RATETBL, which is in another control sec- 
tion, the following coding might be used: 



Note 2 ; When external symbols are used 
in an expression they may not be paired. 
Each external symbol must be considered as 
having a unique relocatability attribute. 



Addressing External Control Sections 



A common way for a program to link to an 
external control section is to: 

1. Create a V-type address constant with 
the name of the external symbol. 

2. Load the constant into a general reg- 
ister and branch to the control section 
via the register. 



Name 



f 



joperation | Operand 



4- 



--^ 



1 MAINPROG 


1 CSECT 




1 


1 BEGIN 


IBALR 


2,0 






lUSING 
1 . 


*,2 






1 . 
1 EXTRN 

1 • 


RATETBL 






1 . 


4, RATEADDR 






1 USING 


RATETBL, 4 






1 . 


3, RATETBL 




1 RATEADDR 


1 • 
|DC 


A (RATETBL) 






|END 


BEGIN 




L _ _._. — — — _^ 


_J J 


1 


J 
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SECTION ^z MACHINE- INSTRUCTIONS 



Ij.ng 



This section discusses the coc 
machime-instractions represented 
assembler language. The readei" 
that the functions of each inacn 
instruction are discussed in the 
of operation manual (see Preface 



of the 
in the 
is reminded 
ine- 

principles 
). 



they are used. Register numbers are also 
checked to make sure that they specify the 
proper registers, as follows: 

1. Floating-point instructions must spec- 
ify floating-point registers 0, 2, 4, 
or 6. 



MACHINE-INSTRUCTION STATEMENTS 



Machine-instructions may be represented 
symbolically as assembler langtiage 
statements. The symbolic formcit of each 
varies according to the actual machine- 
instruction format, of which there are 
five: RR, RX, RS, SI, and SS. Within each 
basic format, further variatioitis are 
possible. 

The symbolic format of a matthine^ 
instruction is similar to, but does not 
duplicate, its actual format. Appendix C 
illustrates machine format for the five 
classes of instructions. A mnemonic opera- 
tion code is written in the operation 
field, and one or more operands; are written 
in the operand field. Comments; may be 
appended to a raachine-instructi.on statement 
as previously explained in Section 1- 



stal:ement 



Any machine-instruction 
named by a symbol, which other 
statements can use as an oper 
value attribute of the symbol 
address of the leftmost byte - 
the assembled instruction. Th^ 
attribute of the symbol depend 
basic instruction format, as 



Basic Format 

RR 

RX 

RS 

SI 

SS 



and 



ass 



HI 



L ength Attribi)ite 

2 

4 

4 

^ 
6 



may be 
assemiDler 

The 
s the 
igned to 
length 
on the 
lows: 



Instruction Alignment and Checking 



re 



All machine-instructions a 
automatically by the assembler 
boundaries. If any statement 
information to be assembled re 
ment, the bytes skipped are fi 
hexadecimal zeros. All expres 
specify storage addresses are 
insure that they refer to a 
boundaries for the instructions 



aligned 
on half-word 
that causes 
ires align- 
led with 
ions that 
<t::hecked to 

ate 
> in which 



equ 



ppropri 



2. Double-shift, full-word multiply, and 
divide instructions must specify an 
even-numbered general register in the 
first operand. 



OPERAND FIELDS AND SUBFIELDS 



Some symbolic operands are written as a 
single field and other operands are written 
as a field followed by one or two sub- 
fields. For example, addresses consist of 
the contents of a base register and a dis- 
placement. An operand that specifies a 
base and displacement is written as a dis- 
placement field followed by a base register 
subfield, as follows: 40(5). In the RX 
format, both an index register subfield and 
a base register subfield are written as 
follows: 40(3,5). In the SS format, both a 
length subfield and a base register sub- 
field are written as follows: 40(21,5). 

Appendix C shows two types of addressing 
formats for RX, RS, SI, and SS instruc- 
tions. In each case, the first type shows 
the method of specifying an address expli- 
citly, as a base register and displacement. 
The second type indicates how to specify an 
implied address as an expression. 

For example, a load multiple instruction 
(RS format) may have either of the follow- 
ing symbolic operands: 



R1,R3,D2(B2) - 
R1,R3,S2 



- explicit address 
implied address 



Whereas D2 and B2 must be represented by 
absolute expressions, S2 may be represented 
either by a relocatable or an absolute 
expression. 

In order to use implied addresses, the 
following rules must be observed: 

1. The base register assembler instruc- 
tions (USING and DROP) must be used. 

2. An explicit base register designation 
must not accompany the implied 
address. 



Machine- Instructions 
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For example, assume that FIELD is a 
relocatable symbol, which has been assigned 
a value of 7400. Assume also that the 
assembler has been notified (by a USING 
instruction) that general register 12 cur- 
rently contains a relocatable value of 4 096 
and is available as a base register. The 
following example shows a machine- 
instruction statement as it would be 
written in assembler language and as it 
would be assembled. Note that the value of 
D2 is the difference between 7400 and 4096 
and that X2 is assembled as zero, since it 
was omitted. The assembled instruction is 
presented in hexadecimal : 

Assembler statement: 



2,48(4,5) 
2 , FIELD 



(implied address) 



2. If the first subfield in the sequence 
is omitted, the comma that separates 
it from the second subfield is writ- 
ten. The parentheses must also be 
written. 

MVC 32(16,5) ,FIELD2 

MVC BETA(,5),FIELD2 (implied length) 

3. If the second subfield in the sequence 
is omitted, the comma that separates 
it from the first subfield must be 
omitted. The parentheses must be 
written. 



ST 4, FIELD 
Assembled instruction; 



MVC 32(16,5) ,FIELD2 
MVC FIELD1(16),FIELD2 



(implied 
address) 



Op. Code Rl X2 
50 4 



B2 

B 



D2 
CE8 



An address may be specified explicitly 
as a base register and displacement (and 
index register for RX instructions) by the 
formats shown in the first column of Table 
4-1. The address may be specified as an 
implied address by the formats shown in the 
second column. Observe that the two stor- 
age addresses required by the SS instruc- 
tions are presented separately; an implied 
address may be used for one while an expli- 
cit address is used for the other. 



Fields and subfields in a symbolic oper- 
and may be represented either by absolute 
or by relocatable expressions, depending on 
what the field requires. (An expression 
has been defined as consisting of one term 
or a series of arithmetically combined 
terms. ) Refer to Appendix C for a detailed 
description of field requirements. 

Note ; Blanks may not appear in an oper- 
and unless provided by a character self- 
defining term or a character literal. 
Thus, blanks may not intervene between 
fields and the comma separators, between 
parentheses and fields, etc. 



Table 4-1. Details of Address Specifi- 
cation 

r T T 1 

I Type I Explicit Address] Implied Address | 



I 



--^ 



1 RX 


|D2(X2,B2) 


S2(X2) 




1 


|D2(,B2) 


S2 




1 RS 


|D2(B2) 


S2 




1 SI 


|D1(B1) 


SI 




1 SS 


|D1(L1,B1) 


SI (LI) 




1 


|D1(L,B1) 


SKL) 




1 


|D2(L2,B2) 


S2(L2) 




1 


1 J 


L 


J 



A comma must be written to separate 
operands. Parentheses must be written to 
enclose a subfield or subfields, and a 
comma must be written to separate two sub- 
fields within parentheses. When parenthe- 
ses are used to enclose one subfield, and 
the subfield is omitted, the parentheses 
must be omitted. In the case of two sub- 
fields that are separated by a comma and 
enclosed by parentheses, the following 
rules apply: 

1. If both subfields are omitted, the 
separating comma and the parentheses 
must also be omitted. 



LENGTHS — EXPLICIT AND IMPLIED 



The length field in S3 instructions can 
be explicit or implied. To imply a length, 
the programmer omits a length field from 
the operand. The omission indicates that 
the length field is either of the 
following : 

1. The length attribute of the expression 
specifying the displacement, if an 
explicit base and displacement have 
been written. 

2. The length attribute of the expression 
specifying the effective address, if 
the base and displacement have been 
implied. 

In either case, the length attribute for 
an expression is the length of the leftmost 
term in the expression. The length attri- 
bute of asterisk (*) is equal to the length 
of the instruction in which it appears, 
except that in an EQU to ♦ statement, the 
length attribute is 1. 
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By contrast, an explicit lerjjgth 
ten by the programmer in the 
absolute expression. The ex 
overrides any implied length 



is Verit- 
as an 
icit length 



operand 



-XC 



Whether the length is expl 
implied, it is always an effect: 
The value inserted into the lerjigth 
the assembled instruction is 
the effective length in the ma 
instruction statement. 



xt or 

ive length, 
field of 
less than 
(bhine- 



one 



Note : If a length field of 



desired, the length may be s 
or one. 



To summarize, the length recjuired in an 
SS instruction may be specified explicitly 
by the formats shown in the first column of 
Table U-2 or may be implied by the formats 
shown in the second column. OJ^serve that 
the two lengths required in one of the SS 
instruction formats are presented separate- 
ly. An implied length may be used for one 
while an explicit length is us^d for the 
other. : 



?ero xs 

as zero 



tat:ed 



Table U-2. 



Details of Length 
in SS Instructions 



r r 

I Explicit Length | Implied Lefigth 
^ ^ 

D1(L1,B1) I D1(,B1) 

Sl(Ll) I SI 

D1(L,B1) I D1(,B1) 

Sl(L) I SI 

D2(L2,B2) I D2(,B2) 

S2(L2) I S2 



MACHINE- INSTRUCTION MNEMONIC CODES 



pecification 




The mnemonic operation codes (shown in 
Appendix D ) are designed to be easily 
remembered codes that indicate the func- 
tions of the instructions. The normal 
format of the code is shown below; the 
items in brackets are not necessarily pre- 
sent in all codes: 

Verbl Modifier] [Data Type] [Machine Format] 



The verb, which is usually 
characters, specifies the f 
example, A represents Add , 
resents Move. The function ma 
defined by a modifier. For 
modifier L indicates -a logical 
in AL for Add Logical and MV 
C (MVC) to indicate Move Chara 



ons 



Mnemonic codes for functi 
data usually indicate the data 



one or two 
on. For 
MV rep- 
y be further 
e, the 
function, as 
modified by 
cters. 



uncti 
and 



example 



IS 



involving 
types, by 



letters that correspond to those for the 
data types in the DC assembler instruction 
(see Section 5 ) . Furthermore, letters u 
and W have been added to indicate short and 
long, unnormalized floating-point opera- 
tions, respectively. For example, AE indi- 
cates Add Normalized Short, whereas AU 
indicates Add Unnormalized Short. Where 
applicable, full-word fixed-point data is 
implied if the data type is omitted. 



The letters R and I are added to the 
codes to indicate, respectively, RR and SI 
machine instruction formats. Thus, AER 
indicates Add Normalized Short in the RR 
format. Functions involving character and 
decimal data types imply the SS format. 



MACHINE- INSTRUCTION EXAMPLES 



The examples that follow are grouped 
according to machine- instruction format. 
They illustrate the various symbolic oper- 
and formats. All symbols employed in the 
examples must be assumed to be defined 
elsewhere in the same assembly. All sym- 
bols that specify register numbers and 
lengths must be assumed to be equated else- 
where to absolute values. 

Implied addressing, control section 
addressing, and the function of the USING 
assembler instruction are not considered 
here. For discussion of these considera- 
tions and for examples of coding sequences 
that illustrate them, refer to Section 3 , 
Program Sectioning and Linking , and Base 
Register Instructions . 



RR Format 



r r r t 

iName | Operation | Operand j 

^ 1 1 ^ 

lALPHAl I LR I 1,2 1 

IALPHA2 |LR iREGl,REG2 j 

I BETA |SPM I 15 I 

jGAMMAl JSVC 1250 | 

IGAMMA2 I SVC j TEN | 

L J. L J 



The operands of ALPHAl, BETA, and GAMMAl 
are decimal self-defining values, which are 
categorized as absolute expressions. The 
operands of ALPHA2 and GAMMA2 are symbols 
that are equated elsewhere to absolute 
va lues . 



Mach ine- Instructions 
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RX Format 




r 


-1 — 


jNarne 
1 


10 
1 


1 


1 


jALPHAl 


|L 


1 ALPHA2 


|L 


IBETAl 


|L 


1 BETA 2 


|L 


1 GAMMAl 


|L 


1 GAMMA2 


|L 


1 GAM^5A3 


|L 


j LAMBDAl 


>J 



SI Format 



i Operation | Operand 



11,39(4,10) 

|REG1,39(4,TEN) 

|2,ZETA(4) 

1REG2,ZETA{REG4) 

|2,ZETA 

|REG2,ZETA 

)2,=F'1000' 

|3,20(,5) 



[Name 

I- 

JALPHAl 
IALPHA2 
I BETAl 
I BETA2 
j GAMMAl 
IGAMMA2 
IGAMMA3 
I GAMMA 4 
L 



I Operation 

•+ 

|CLI 
JCLI 
JCLI 
jCLI 
|SIO 

jsio 

|SIO 
ISIO 



j Operand 

-+ 

|U0(9),X«40* 
I 40 (REG 9) ,TEN 
I Z ETA, TEN 
I ZETA,C'A* 
|40(9) 
I 0(9) 
lUO(O) 
IZETA 



Both ALPHA instructions specify explicit 
addresses; REGl and TEN are absolute sym- 
bols. Both BETA instructions specify 
implied addresses, and both use index reg- 
isters. Indexing is omitted from the GAMMA 
instructions. GAMMAl and GAMMA2 specify 
implied addresses. The second operand of 
GAMMA3 is a literal. LAMBDAl specifies no 
indexing. 



RS Format 



r • T T 1 

I Name | Operation | Operand | 

lALPHAl jBXH 11,2,20(14) 

IALPHA2 JBXH | REGl, REG2, 20(REGD) 

1 ALPH A3 I BXH | REGl , REG2 , ZETA 

IALPHA4 jSLL 1REG2,15 

1ALPHA5 jSLL 1REG2,0(15) 

L L X 



Whereas ALPHAl and ALPHA2 specify ex- 
plicit addresses, ALPHA3 specifies an 
implied address. ALPHA4 is a shift 
instruction shifting the contents of REG2 
left 15 bit positions. ALPHAS is a shift 
instruction shifting the contents of REG2 
left by the value contained in general 
register 15. 



The ALPHA instructions and GAMMAl- GAMM A3 
specify explicit addresses, whereas the 
BETA instructions and GAMMA4 specify 
implied addresses. GAMMA2 specifies a 
displacement of zero. GAMMA3 does not 
specify a base register. 



SS Format 




r 


_^«^ 


_._„._,,___,.,,__—.__,_._,„.,-.,_._,.«.__ ..,.,._. . 


iName 


1 Opera ti on | Operand | 


L — « 


j._ ^ 


_. I , ,, . . . ... „ „ . ,„ 1 


r 




^ ^ 


1 ALPHAl 


|AP 


|40(9,8),30(6,7) 1 


1 ALPHA2 


lAP 


|40 (NINE, REGS), 30 (L6, 7) j 


1 ALPH A3 


jAP 


|FIELD2,FIELD1 J 


1 ALPH A 4 


lAP 


1 FI ELD2 ( 9 ) , FIELDl ( 6 ) | 


IBETA 


1 AP 


1FIELD2(9) ,FIELD1 j 


1 GAMMAl 


IMVC 


140 (9,8) ,30(7) 1 


1GAMMA2 


|MVC 


1 40 (NINE, REGS) , DEC (7) j 


IGAMMA3 


jMVC 


1FIELD2, FIELDl | 


1 GAMMA4 


IMVC 


|FIELD2( 9), FIELDl 1 


1 ^ .,.. 


1 


J. i 



ALPHAl, ALPHA2, GAMMAl, and GAMMA2 spec- 
ify explicit lengths and addresses. ALPHA3 
and GAMMA3 specify both implied length and 
implied addresses. ALPHA4 and GAMMA4 spec- 
ify explicit length and implied addresses. 
BETA specifies an explicit length for 
FIELD2 and an implied length for FIELDl; 
both addresses are implied - 



EXTENDED MNEMONIC CODES 



For the convenience of the programmer, the 
assembler provides extended mnemonic codes, 
which allow conditional branches to be 
specified ranemonically as well as through 
the use of the BC machine-instruction. 
These extended mnemonic codes specify both 
the machine branch instruction and the 
condition on which the branch is to occur. 
The codes are not part of the universal set 
of machine-instructions, but are translated 



36 



Extended Code 

B D2(X2,B2) 
BR R2 
NOP D2(X2,B2) 
NOPR R2 



Meaning 

Branch Unccjnditional 
Branch Unconditional 
No Operation 
No Operation 



BH 

BL 

BE 

BNH 

BNL 

BNE 



BO 

BP 

BM 

BZ 

BNP 

BNM 

BN2 



Used After Compare Instructions 

D2(X2,B2) Branch on riigh 

D2(X2,B2) Branch on low 

D2(X2,B2) Branch on Equal 

D2<X2,B2) Branch on Not High 

D2(X2,B2) Branch on Not Low 

D2(X2,B2) Branch on I^ot Equal 



Used After Arithmetic Ins 



D2(X2*B2) 
D2(X2,B2) 
D2(X2,B2) 
D2(X2,B2) 
D2(X2,B2) 
D2(X2,B2) 
D2(X2,B2) 



Branch on 
Branch on 
Branch on 
Branch on 
Branch on 
Branch on 
Branch on 



Used After Test Under Mask Instructions 



BO D2(X2,B2) 

BM D2(X2,B2) 

BZ D2(X2,B2) 

BNO D2(X2,B2) 

Figure k-l. Extended Mnemonic 



Branch if Ones 
Branch if 
Branch if Z 
Branch if 



(RR format) 
(RR format) 



tructions 



ojverf low 
aus 

.nus 
iero 

Plus 

Minus 

Zero 



Not 
Not 
Not 



Mixed 
eros 
Ones 



Not 



Codes 



Machine- Instruction 

BC 15,D2(X2,B2) 

BCR 15, R2 

BC 0,D2{X2,B2) 

BCR 0,R2 



BC 2,D2(X2,B2) 
BC 4,D2(X2,B2) 
BC 8,D2(X2,B2) 
BC 13,D2(X2,B2) 
BC 11,D2{X2,B2) 
BC 7,D2(X2,B2) 



BC 1,D2(X2,B2) 
BC 2,D2(X2,B2) 
BC a,D2(X2,B2) 
BC 8,D2(X2,B2) 
BC 13,D2(X2,B2) 
BC 11,D2(X2,B2) 
BC 7,D2(X2,B2) 



BC 1,D2(X2,B2) 
BC 4,D2(X2,B2) 
BC 8,D2(X2,B2) 
BC 14,D2(X2,B2) 






by the assembler into the corresponding 
operation and condition combinations. 



The allowable extended mnem 
and their operand formats are 
Figure ti-1, together with thei 
instruction equivalents. Unle 
noted, all extended mnemonics 
instructions in the RX format, 
the only difference between th 
fields of the extended mnemoni 
of their machine-instruction e 
the absence of the Rl field anc 
that separates it from the res 
operand field. The extended m 
like the machine-instruction 1 
explicit address formats only, 
address can also be specified ^ 
address. I 



nic codes 
hown in 

machine- 
s otherwise 
hown are for 

Note that 

operand 
s and those 
uivalents is 

the comma 

of the 
emonic list, 
St, shows 

Each 
s an implied 



In the following examples, which illus- 
trate the use of extended mnemonics, it. is 
to be assumed that the symbol GfO is defined 
elsewhere in the program. 



I Name | Operation ) Operand 

|B |U0(3,6) 

|B |U0(,6) 

|BL I GO (3) 

I BL I GO 

I BR I 4 

L X X 



The first two instructions specify an 
unconditional branch to an explicit 
address. The address in the first case is 
the sum of the contents of base register 6, 
the contents of index register 3, and the 
displacement 40; the address in the second 
instruction is not indexed. The third 
instruction specifies a branch on low to 
the address implied by GO as indexed by the 
contents of index register 3; the fourth 
instruction does not specify an index reg- 
ister. The last instruction is an uncondi- 
tional branch to the address contained in 
register 4. 



Machine- Instructions 
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SECTION 5: ASSEMBLER INSTRUCTION STATEMENTS 



Just as machine instructions are used to 
request the computer to perforin a sequence 
of operations during program execution 
time, so assembler instructions are 
requests to the assembler to perform cer- 
tain operations during the assembly. 
Assembler-instruction statements, in 
contrast to machine-instruction statements, 
do not always cause ma chine- instruct ions to 
be included in the assembled program. 
Some, such as DS and DC, generate no 
instructions but do cause storage areas to 
be set aside for constants and other data. 
Others, such as EQU and SPACE, are effec- 
tive only at assembly time; they generate 
nothing in the assembled program and have 
no effect on the Location Counter. 



SYMBOL DEFINITION INSTRUCTION 



EQU — EQUATE SYMBOL 



The EQU instruction is used to define a 
symbol by assigning to it the attributes of 
an expression in the operand field. The 
typical form of the EQU instruction state- 
ment is as follows: 



r r "r -i 

I Name [Operation | Operand | 

^ + ^ ^ 

I A symbol | EQU | An expression | 

L L L J 



The following is a list of all the 
assembler instructions. 

Symbol Definition Instruction 
EQU - Equate Symbol 

Data Definition Instructions 

DC - Define Constant 

DS - Define Storage 

CCW - Define Channel Command Word 

* Program Sectioning and Linking Instruc- 
tions 

START - Start Assembly 
CSECT - Identify Control Section 
DSECT - Identify Dummy Section 
ENTRY - Identify Entry-Point Symbol 
EXTRN - Identify External Symbol 
COM - Identify Blank Common Control 
Section 



The expression in the operand field may 
be absolute or relocatable. Any symbols 
appearing in the expression must be pre- 
viously defined. 

The symbol in the name field is given 
the same attributes as the expression in 
the operand field. The length attribute of 
the symbol is that of the leftmost (or 
only) term of the expression. When that 
term is *, the length attribute is 1. The 
value attribute of the symbol is the value 
of the expression. 

The EQU instruction is the means of 
equating symbols to register numbers, 
immediate data, and other arbitrary values. 
The following examples illustrate how this 
might be done: 



* Base Register Instructions 
USING - Use Base Address Register 
DROP - Drop Base Address Register 

Listing Control Instructions 
TITLE - Identify Assembly Output 
EJECT - Start New Page 
SPACE - Space Listing 
PRINT - Print Optional Data 

Program Control Instructions 

ICTL - Input Format Control 

ISEQ - Input Sequence Checking 

ORG - Set Location Counter 

LTORG - Begin Literal Pool 

CNOP - Conditional No Operation 

COPY - Copy Predefined Source Coding 

END - End Assembly 

PUNCH - Punch a Card 

REPRO - Reproduce Following Card 

♦ Discussed in Section 3. 



JName | Operation | Operand j 

j. 1 + ^ 

|REG2 I EQU 1 2 (general register) | 

ITEST |EQU |X* 3F* (iromediate data) | 



To reduce programming time, the program- 
mer can eq^aate symbols to frequently used 
expressions and then use the symbols as 
operands in place of the expressions. 
Thus, in the statement 



r r T 

I Name [Operation [Operand 



l~- 



[FIELD [EQU 



I 

I ALPHA-BETA +GAMMA 
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Note 



FIELD is defined as ALPHA-BETA+ 
may be used in place of it 
that ALPHA, BETA, and GAMMA roust 
previously defined. 



DATA DEFINITION INSTRUCTIONS 



eAMMA and 

however , 
all be 



There are three data definition 
statements: Define Constant (DC 
Storage (DS) , and Define Channe 
Word (CCW). 



instruction 
> , Define 
1 Command 



enter data 



These statements are used to 
constants into storage, to define and re- 
serve areas of storage, and to specify the 
contents of channel command words. The 
statements may be named by symbols so that 
other program statranents can refer to the 
fields generated from them. The discussion 
of the DC instruction is far more extensive 
than that of the DS instruction 
the DS instruction is written in the same 
format as the DC instruction and may speci- 
fy some or all of the in forma tipn that the 
DC instruction provides. Only 
and treatment of the statements 
this reason, the DC instruction 
ed first and discussed in more 
the DS instruction - 



the function 
vary. For 
is present- 
detail than 



tarts 



DC — DEFINE CONSTANT 



The DC instruction is used to 
stant data in storage. It may 
constant or a series of cons 
relieving the programmer of the 
to write a separate data defini 
ment for each constant desired 
more, a variety of constants ma 
fied: fixed-point, floating-poi 
hexadecimal, character, and sto 
addresses. (Data constants are 
called constants unless they ar 
from storage addresses, in whi 
are called address constants.) 
form of the DC instruction 
follows: 



ch 



j Name j Operation j Operand 

I A symbol |DC jone operand in 

I or not I I the format 

1 used I Idescritied in the 

I I [following text. | 

I X L 



Each operand consists of 
the first three describe the c 
the fourth subfield provides 



provide con- 
specify one 
thereby 
necessity 
tion state- 
Fur the r- 
y be speci- 
nt, decimal, 
rage 

generally 
e created 
case they 
The typical 
is as 



statement 



four subfields; 
onstant, and 
the constant 



or constants. The first and third sub- 
fields may be omitted, but the second and 
fourth must be specified. Note that more 
than one constant may be specified in the 
fourth subfield for most types of con- 
stants. Each constant so specified must be 
of the same type; the descriptive subfields 
that precede the constants apply to all of 
them. No blanks may occur within any of 
the subfields (unless provided as charac- 
ters in a character constant), nor may they 
occur between the subfields of an operand. 

The subfields of the DC operand are 
written in the following sequence: 



I Subfield 1 

I 1 2 3 U I 

jDupli- j Type j Modifiers I Constant (s) ( 
I cation) j | | 

j Factor I | ) | 

I : -X- L X J 

The symbol that naones the DC instruction 
is the name of the constant (or first con- 
stant if the instruction specifies more 
than one). Relative addressing (e.g., 
SYMBOL+2) may be used to address the var- 
ious constants if more than one has been 
specified, because the number of bytes 
allocated to each constant can be deter- 
mined. 

The value attribute of the symbol naming 
the DC instruction is the address of the 
leftmost byte (after any necessary 
alignment) of the first, or only, constant. 
The length attribute depends on two things: 
the type of constant being defined and the 
presence of a length specification. 
Implied lengths are assumed for the various 
constant types in the absence of a length 
specification. If more than one constant 
is defined, the length attribute is the 
length in bytes (specified or implied) of 
the first constant. 

Boundary alignment also varies according 
to the type of constant being specified and 
the presence of a length specification. 
Some constant types are only aligned to a 
byte boundary, but the DS instruction can 
be used to force any type of word boundary 
alignment for them. This is explained 
under "DS — Define Storage." Other con- 
stants are aligned at various word boundar- 
ies (half, full, or double) in the absence 
of a length specification. If length is 
specified, no boundary alignment occurs for 
such constants. 

Bytes that must be skipped in order to 
align the field at the proper boundary are 
not considered to be part of the constant. 
In other words, the Location Counter is 
incremented to reflect the proper boundary 
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(if any incrementing is necessary) before 
the address value is established. Thus, 
the symbol naming the constant will not 
receive a value attribute that is the loca- 
tion of a skipped byte. 

Any bytes skipped in aligning statements 
that do not cause information to be assem- 
bled are not zeroed. Thus bytes skipped to 
align a statement such as DC F'123' are 
zeroed, and bytes skipped to align a state- 
ment such as DS F*123' are not zeroed. 



DS instruction. A DC instruction with a 
zero duplication factor will not produce 
control dictionary entries. See "Forcing 
Alignment" under "DS — Define Storage." 

Note ; If duplication is specified for an 
address constant containing a Location 
Counter reference, the value of the Loca- 
tion Counter used in each duplication is 
incremented by the length of the operand. 



Appendix F summarizes, in chart form, 
the information concerning constants that 
is presented in this section. 

LITERAL DEFINITIONS: The reader is remind- 
ed that the discussion of literals as 
machine-instruction operands (in Section 2) 
referred him to the description of the DC 
operand for the method of writing a literal 
operand. All subsequent operand specifi- 
cations are applicable to writing literals, 
the only differences being: 

1. The literal is preceded by an = sign. 

2. Unsigned decimal values may be used to 
express the duplication factor and 
length modifier values. 

3. The duplication factor may not be 
zero. 

4. S-type address constants may not be 
specified. 

5. Signed or unsigned decimal values may 
be used for exponent and scale modifi- 
er values. 

Examples of literals appear throughout 
the balance of the DC instruction discus- 
sion. 



Operand Subfield 1: Duplication Factor 



The duplication factor may be omitted. If 
specified, it causes the constant (s) to be 
generated the number of times indicated by 
the factor. The factor may be specified 
either by an unsigned decimal self-defining 
term or by a positive absolute expression 
that is enclosed by parentheses. The 
duplication factor is applied after the 
constant is assembled. All symbols in the 
expression must be previously defined. 

Note that a duplication factor of zero 
is permitted except in a literal and 
achieves the same result as it would in a 



Operand Subfield 2; Type 



The type subfield defines the type of con- 
stant being specified. From the type 
specification, the assen:ibler determines how 
it is to interpret the constant and trans- 
late it into the appropriate machine for- 
mat. The type is specified by a single- 
letter code as shown in Figure 5-1. 

Further information about these 
constants is provided in the discussion of 
the constants themselves under "Operand 
Subfield 4: Constant." 



Operand Subfield 3; Modifiers 



Modifiers describe the length in bytes 
desired for a constant (in contrast to an 
implied length) , and the scaling and expo- 
nent for the constant. If multiple modifi- 
ers are written, they must appear in this 
sequence: length, scale, exponent. Each is 
written and used as described in the fol- 
lowing text. 

LENGTH MODIFIER; This is written as Ln, 
where n is either an unsigned decimal self- 
defining term or a positive absolute 
expression enclosed by parentheses. Any 
symbols in the expression must be previous- 
ly defined. The value of n represents the 
number of bytes of storage that are assem- 
bled for the constant. The maximum value 
permitted for the length modifiers supplied 
for the various types of constants is sum- 
marized in Appendix F. This table also 
indicates the implied length for each type 
of constant; the implied length is used 
unless a length modifier is present. A 
length modifier may be specified for any 
type of constant. However, no boundary 
alignment will be provided when a length 
modifier is given. 
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■*"""—'•""" 


•-~~~~" ——————————————— 


code 


Type of Constant 


C 


Character 


X 


Hexadecirnal 


B 


Binary 


F 


Fixed- point 


H 


Fixed-point 


E 


Floating-point 


D 


Floating-point 


P 


Decimal 


Z 


Decimal 


A 


Address 


Y 


Address 


S 


Address 



V 



Address 



machine Format 

-bit code for each character 

-bit code for each hexadecimal digit 

inary format 

igned, fixed- point binary format; 

ormaliy a full word 

igned, fixed- point binary format; 

orroally a half word 
i^hort floating-point format; 
formally a full word 
Long floating-point format; 
normally a double word 
Packed decimal format 
^oned decimal format 

alue of address; normally a full word 
^alue of address; normally a half word 
^ase register and displacement value; 

half word 
Space reserved for external 
symbol addresses; each 
^ddress normally a full word 



Figure 5-1, Type Codes for Constants 



SCALE MODIFIER: This modifier 



enclosed 



The 



as Sn, where n is less than 14 
er an unsigned decimal self-def 
or an absolute expression 
ren theses. Any symbol in the 
must be previously defined, 
value or the parenthesized e 
be preceded by a sign; if none 
a plus sign is assumed. The 
for scale modifiers are sumraari 
Appendix F, 



is written 
and is eith- 
ining term 
by pa- 
xpression 
decimal 
si on may 
is present, 
mil xi mum values 
zed in 



xp;res£ 



A scale modifier may be used with fixed- 
point (F, H) and f loating-poin:: (E, D) 
constants only. It is used to specify the 
amount of internal scaling thajt is desired, 
as follows. 



Scale Modifier for Fixed-Point 



the scale modifier specifies 
two by which the constant must 
multiplied after it has been 
its binary representation, 
plication of a decimal number 
10 causes the decimal point to 
plication of a binary number 
two causes the binary point to 
multiplication has the effect 
binary point away from its as 
in the binary field; the a 
being to the right of the r 
tion. 



tfie 



Just 



W 



issumed 



Thus, the scale modifier indicates ei- 



ther of the following: (1) the 



binary positions to be occupied by the 



fractional portion of the bina 



Constants: 



power of 
be 
cbnverted to 
as multi- 
ay a power of 
move, raulti- 

a power of 
move. This 
Df moving the 
position 
position 
posi- 



sbmed 



ightmost 



number of 



ry number, or 



(2) the number of binary positions to be 



deleted from the integral portion of the 
binary number. A positive scale of x 
shifts the integral portion of the number x 
binary positions to the left, thereby re- 
serving the rightmost x binary positions 
for the fractional portion. A negative 
scale shifts the integral portion of the 
number right, thereby deleting rightmost 
integral positions. A scale factor which 
causes loss of all significance should not 
be used. If a scale modifier does not 
accompany a fixed-point constant containing 
a fractional part, the fractional part is 
lost. 

In all cases where positions are lost 
because of scaling (or the lack of 
scaling), rounding occurs in the leftmost 
bit of the lost portion. The rounding is 
reflected in the rightmost position saved. 



Scale Modifier for Floating-Point Con- 
stants ; Only a positive scale modifier may 
be used with a floating-point constant. It 
indicates the number of hexadecimal posi- 
tions that the fraction is to be shifted to 
the right. Note that this shift amount is 
in terms of hexadecimal positions, each of 
which is four binary positions. (A posi- 
tive scaling actually indicates that the 
point is to be moved to the left. However, 
a floating-point constant is always con- 
verted to a fraction, which is hexadeci- 
m.ally normalized. The point is assumed to 
be at the left of the leftmost position in 
the field. Since the point cannot be nioved 
left, the fraction is shifted right.) 
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Thus, scaling that is specified for a 
floating-point constant provides an assem- 
bled fraction that is unnorroalized, i.e., 
contains hexadecimal zeros in the leftmost 
positions of the fraction. When the frac- 
tion is shifted, the exponent is adjusted 
accordingly to retain the correct magni- 
tude. When hexadecimal positions are lost, 
rounding occurs in the leftmost hexadecimal 
position of the lost portion. The rounding 
is reflected in the rightmost hexadecimal 
position saved. 

EXPONENT MODIFIER; This modifier is writ- 
ten as En, where n is either a decimal 
self-defining term or an absolute expres- 
sion enclosed by parentheses. Any symbols 
in the expression must be previously 
defined. The decimal value or the paren- 
thesized expression may be preceded by a 
sign; if none is present, a plus sign is 
assumed. The maximum values for exponent 
modifiers are summarized in Appendix F . 

An exponent modifier may be used with 
fixed-point (F, H) and floating-point (E, 
D) constants only. The modifier denotes 
the power of 10 by which the constant is to 
be multiplied before its conversion to the 
proper internal format. 

This modifier is not to be confused with 
the exponent of the constant itself, which 
is specified as part of the constant and is 
explained under "Operand Subfield H; Con- 
stant." Both are denoted in the same 
fashion, as En. The exponent modifier 
affects each constant in the operand, 
whereas the exponent written as part of the 
constant only pertains to that constant. 
Thus, a constant may be specified with an 
exponent of +2, and an exponent modifier of 
+5 may precede the constant. In effect, 
the constant has an exponent of +7. 

Note that there is a maximum value, both 
positive and negative, listed in Appendix F 
for exponents. This applies both to expo- 
nent modifier and exponents specified as 
part of the constant, or to their sum if 
both are specified. 



Operand Subfield 4; Constant 



This subfield supplies the constant (or 
constants) described by the subfields that 
precede it. A data constant (all types 
except A,Y,S,and V) is enclosed by apos- 
trophes . An address constant (types A, Y, 
S, and V) is enclosed by parentheses. To 
specify two or more constants in the sub- 
field, the constants must be separated by 
commas and the entire sequence of constants 
must be enclosed by the appropriate delimi- 
ters (i.e., apostrophes or parentheses). 



Thus, the format for specifying the 
constant (s) is one of the following: 



Single 
Constant 
•constant* 
(constant) 



Multiple 
Constants* 
'constant, . 
(constant, . 



, constant* 
, constant) 



♦ Not permitted for character, hexadecimal, 
and binary constants. 

All constant types except character (C) , 
hexadecimal (X), binary (B), packed decimal 
(P), and zoned decimal (Z), are aligned on 
the proper boundary, as shown in Appendix 
F, unless a length modifier is specified. 
In the presence of a length modifier, no 
boundary alignment is performed. If the 
operand specifies more than one constant, 
any necessary alignment applies to the 
first constant only. Thus, for an operand 
that provides five full-word constants, the 
first would be aligned on a full-word 
boundary, and the rest would automatically 
fall on full-word boundaries. 

The total storage requirement of the 
operand is the product of the length times 
the number of constants in the operand 
times the duplication factor (if present) 
plus any bytes skipped for boundary align- 
ment. 

If an address constant contains a Loca- 
tion Counter reference, the Location Count- 
er value that is used is the storage 
address of the first byte the constant will 
occupy. Thus, if several address constants 
in the same instruction refer to the Loca- 
tion Counter, the value of the Location 
Counter varies from constant to constant. 
Similarly, if a single constant is speci- 
fied (and it is a Location Counter 
reference) with a duplication factor, the 
constant is duplicated with a varying Loca- 
tion Counter value. 

When there are two data types for a 
given constant, specifying two different 
implied lengths, such as E and D or H and 
F, and the shorter data type is used, the 
constant is evaluated to the maximum length 
and shortened to fit the type specified. 
For instance, E and H constants in this 
case would be evaluated as if they were D 
and F, respectively, and then shortened. 

The subsequent text describes each of 
the constant types and provides examples. 



Character Constant — C; Any of the valid 
256 punch combinations may be designated in 
a character constant. Only one character 
constant may be specified per statement. 



Special consideration must be given to 
presenting apostrophes and ampersands as 
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characters. Each apostrophe or ampersand 
desired as a character in the constant must 
be represented by a pair of apostrophes or 
ampersands. Only one apostrophe or amper- 
sand appears in storage. 



r r r 1 

I Name j Operation J Ope rand | 

j FIELD IDC 13CL4' ABODE' | 



The maximum length of a character con- 
stant is 256 bytes. No boundary alignment 
is performed. Each character is translated 
into one byte. Double apostrophes or dou- 
ble ampersands count as one character. If 
no length modifier is given, the size in 
bytes of the character constant is equal to 
the number of characters in the constant. 
If a length modifier is provided, the 
result varies as follows: 



If the number of characters in the 
constant exceeds the specified length, 
as many rightmost bytes ab necessary 
are dropped. 

If the number of characters is less 
than the specified length, the excess 
rightmost bytes are filled with 
blanks. 



The generated constant would be: 

ABCDABCDABCD 

On the other hand, if the length had 
been specified as six instead of four, the 
generated constant would have been: 

ABODE ABODE ABODE 

Note that the same constant could be 
specified as a literal. 



I r T~ 1 

I Name j Operation | Operand j 

^ 1 + ^ 

1 I MVC I AREA(12),=3CL4* ABODE* I 

L , X L ^ J 



In the following example, the length 
attribute of FIELD is 12: 



r T T 1 

I Name | Operation | Operand | 

I FIELD I DC IC'TOTAL IS 110* | 

L JL i. . . J 



However, in this next example, the 
length attribute is 15, and three blanks 
appear in storage to the right of the zero: 



r T ■ — T ^ ' 1 

I Name | Operation | Operand | 

^ + ^_-+ ^ 

[FIELD I DC JCLIS'TOTAL IS 110* j 

L ± J . , J 



In the next example, the length attri- 
bute of FIELD is 12, although 13 characters 
appear in the operand. The two ampersands 
count as only one byte. 

I T T -* 1 

I Name | Operation [Operand | 

I 1 1 . -I 

I FIELD I DC I C TOTAL IS SSIO' | 

III I 

L X . X . J 



Note that in the next example, a length 
of four has been specified, but there are 
five characters in the constant. 



Hexadecimal Constant — X: A hexadecimal 
constant consists of one or more of the 
hexadecimal digits, which are 0-9 and A-F. 
Only one hexadecimal constant may be speci- 
fied per statement. The maximum length of 
a hexadecimal constant is 256 bytes (512 
hexadecimal digits). No word boundary 
alignment is performed. 

Constants that contain an even number of 
hexadecimal digits are translated as one 
byte per pair of digits. If an odd number 
of digits is specified, the leftmost byte 
has the leftmost four bits filled with a 
hexadecimal zero, while the rightmost four 
bits contain the odd (first) digit. 

If no length modifier is given, the 
implied length of the constant is half the 
number of hexadecimal digits in the con- 
stant (assuming that a hexadecimal zero is 
added to an odd number of digits). If a 
length modifier is given, thti constant is 
handled as follows: 

1. If the number of hexadecimal digit 
pairs exceeds the specified length, 
the necessary leftmost bits (and/or 
bytes) are dropped. 

2. If the number of hexadecimal digit 
pairs is less than the specified 
length, the necessary bits (and/or 
bytes) are added to the left and 
filled with hexadecimal zeros. 

An eight- digit hexadecimal constant 
provides a convenient way to set the bit 
pattern of a full binary word. The con- 
stant in the following example would set 
the first and third bytes of a word to I's. 
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r ' T T 1 

I Name | Operation j Operand | 

^ + 1 ^ 

I IDS I OF 1 

I TEST I DC IX'FFOOFFOO' j 

I ± L J 



I Name j Operation j Operand 

I BOON I DC I B' 11011101' 

jBTRUNC I DC IBLlMOOlOOOll' 

JBPAD I DC JBLl'lOl' 

L L L 






The DS instruction sets the location 
counter to a full word- boundary - 



The next example uses a hexadeciiral 
constant as a literal and inserts Is into 
bits 24 through 31 of register 5. 



r T T 1 

I Name | Operation | Operand | 

y 1 1 ^ 

I |IC |5,=X'FF' INSERT CHAR. | 

I X L J 



In the following example, the digit A 
would be dropped, because five hexadecimal 
digits are specified for a length of two 
bytes: 



I r r 1 

I Name | Operation | Operand | 

|. 1— 1 ^ 

JALPHACON I DC |3XL2'A6FUE' | 

III I 

L J. ± J 

The resulting constant would be 6FUE, 
which would occupy the specified two bytes. 
It would then be duplicated three times, as 
requested by the duplication factor. If it 
had merely been specified as X'A6F4E', the 
resulting constant would have had a hexa- 
decimal zero in the leftmost position: 

0A6FUE 



Binary Constant — B; A binary constant is 
written using I's and 0*s enclosed in apos- 
trophes. Only one binary constant may be 
specified in a statement. Duplication and 
length may be specified. The maximum 
length of a binary constant is 256 bytes. 

The implied length of a binary constant 
is the number of bytes occupied by the 
constant including any padding necessary. 
Padding or truncation takes place on the 
left. The padding bit used is a 0. 

The following example shows the coding 
used to designate a binary constant. SCON 
would have a length attribute of one. 



BTRUNC would assemble with the leftmost 
bit truncated, as follows: 

00100011 

BPAD would assemble with five zeros as 
padding, as follows: 

00000101 

Fixed-Point Constants — F and H: A fixed- 
point constant is written as a decimal 
number, which may be followed by a decimal 
exponent if desired. The number may be an 
integer, a fraction, or a mixed number 
(i.e., one with integral and fractional 
portions). The format of the constant is 
as follows: 

1. The number is written as a signed or 
unsigned decimal value. Only ten 
digits are significant. High-order 
zeros are ignored. The decimal point 
may be placed before, within, or after 
the number, or it may be omitted, in 
which case the number is assumed to be 
an integer. A positive sign is 
assumed if an unsigned number is spec- 
ified. Unless a scale modifier accom- 
panies a mixed number or fraction, the 
fractional portion is lost, as 
explained under Subfield 3; Modifiers . 

2. The exponent is optional. If speci- 
fied, it is written immediately after 
the number as En, where n is an 
optionally signed deciirial value speci- 
fying the exponent of the factor 10. 
The exponent may be in the range -85 
to +75. If an unsigned exponent is 
specified, a plus sign is assumed. 
The exponent causes the value of the 
constant to be adjusted by the power 
of 10 that it specifies. The exponent 
may exceed the permissible range for 
exponents provided that the sum of the 
exponent and the exponent modifier do 
not exceed that range. 



The number is converted 
binary number and scaling 
specified. The binary num, 
rounded and assembled into 
field, according to the sp 
implied length- If the va 
exceeds the length speciii 
the sign is lost, the nece 
bits are truncated to the 
field and the value is the 
the whole field. Any dupl 
that is present is applied 



to a 64-bit 
is performed, if 
ber is then 

the proper 
ecified or 
lue of the number 
ed or implied, 
ssary leftmost 
length of the 
n assembled into 
ication factor 

after the con- 
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stant is assembled. A negative number is 
carried in 2*s complement form. 



The same constant could be specified as 
a literal: 



An implied length of four bytes is 
assumed for a full-word (F) and two bytes 
for a half-word (H), and the constant is 
aligned to the proper full-word or half- 
word boundary, if a length is riot 
specified. However, any length up to and 
including eight bytes may be specified for 
either type of constant by a length modifi- 
er, in which case no boundary alignment 
occurs. 

Maximum and minimum values, exclusive of 
scaling, for fixed-point constants are: 



r T T 1 

I Name | Operation | Operand | 

I. + + ^ 

I I AH |7,=HS12'3.50E-2* | 

L X J J 



The final example specifies three con- 
stants. Notice that the scale modifier 
requests four bits for the fractional por- 
tion of each constant. The four bits are 
provided whether or not the fraction 
ex ists . 



Length 


Max 


Min 


8 


26 3-1 


-2«3 


H 


23^-1 


-2-*^ 


2 


21S-1 


_2i.s 


1 


2-'-l 


-2f 



A field of three full-words is generated 
from the statement shown below. The loca- 
tion attribute of CONWRD is the address of 
the leftmost byte of the first word, and 
the length attribute is four, the implied 
length for a full-word fixed-point con- 
stant. The expression CONWRD+4 could be 
used to address the second constant (second 
word) in the field. 



r -T T 1 

j Name [Operation [Operand | 

1 -I- 1 ^ 

JTHREECON | DC |FSU ' 10, 25.3,100 • j 

L X L J 



Floating-Point Constants — E and D; A 
floating-point constant is written as a 
decimal number, which may be followed by a 
decimal exponerit, if desired. The number 
may be an integer, a fraction, or a mixed 
number (i.e., one with integral and frac- 
tional portions) . The format of the con- 
stant is as follows: 



I T T • ' 1 

I Name | Operation | Operand | 

I CONWRD I DC |3F'65847U' | 

L J. X _• J 



The next statement causes the generation 
of a two-byte field containing a negative 
constant. Notice that scaling has been 
specified in order to reserve six bits for 
the fractional portion of the constant. 



I T ' T • 1 

I Name | Operation [Operand | 

jHALFCON IDC |HS6'-25.U6' | 

L X J ^ J 



The next constant (3-50) is multiplied 
by 10 to the -2 before being converted to 
its binary format. The scale modifier 
reserves twelve bits for the fractional 
portion. 



r T T • 1 

[Name [Operation [Operand [ 

^ + + _ H 

[FULLCON [DC [HS12 ' 3.50E-2' [ 

(L J J , , J 



1. The number is written as a signed or 
unsigned decimal value. Only ten 
digits are significant. High-order 
zeros are ignored. The decimal point 
may be placed before, within, or after 
the number, or it may be omitted, in 
which case, the number is assumed to 
be an integer. A positive sign is 
assumed if an unsigned number is spec- 
ified. 

2. The exponent is optional. If speci- 
fied, it is written immediately after 
the number as En, where n is an 
optionally signed decimal value speci- 
fying the exponent of the factor 10. 
The exponent may be in the range -85 
to +75. If an unsigned exponent is 
specified, a plus sign is assumed. 

Machine format for a floating-point 
number is in two parts: the portion con- 
taining the exponent, which is sometimes 
called the characteristic, followed by the 
portion containing the fraction, which is 
sometimes called the mantissa. Therefore, 
the number specified as a floating-point 
constant must be converted to a fraction 
before it can be translated into the proper 
fornat. For example, the constant 27.35E2 
represents the number 27.35 times 10 to the 
2nd. Represented as a fraction, it would 
be .2735 times 10 to the Uth, the exponent 
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having been modified to reflect the shift- 
ing of the decimal point. The exponent may 
also be affected by the presence of an 
exponent modifier, as explained under Oper- 
and Subfield 3: Modifiers . 

The exponent is then translated into its 
binary equivalent, and the fraction is 
converted to a 64- bit binary number. 

Scaling is performed if specified; if not, 
the fraction is normalized (leading hexa- 
decimal zeros are removed) . Rounding of 
the fraction is then performed according to 
the specified or implied length, and the 
number is assembled into the proper field, 
within the portion of the floating-point 
field allocated to the fraction, the hexa- 
decimal point is assumed to be to the left 
of the leftmost hexadecimal digit, and the 
fraction occupies the leftmost portion of 
the field. Negative fractions are carried 
in true representation, not in the 2's 
complement form. 

An implied length of four bytes is 
assumed for a full-word (E) and eight bytes 
is assumed for a double-word (D). The 
constant is aligned at the proper word or 
double word boundary if a length is not 
specified. However, any length up to and 
including eight bytes may be specified for 
either type of constant by a length modifi- 
er, in which case no boundary alignment 
occurs. 

Any of the following statements could be 
used to specify HS.mS as a positive, full- 
word, floating-point constant; the last is 
a machine- instruction statement with a 
literal operand. Note that the last two 
constants contain an exponent modifier. 



JMame | Operation | Operand | 

I I DC |E*46.U15« 

I I DC |E'a6415E-3« 

I |DC |E*+464.15E-1' 

I |DC |E*+.46415E+2' 

I )DC 1EE2*. 46415* 

I |AE |6,=EE2'. 46415' 

t J. J. . J 

The following would each be generated as 
double-word floating-point constants. 

, ^ ^ , 

I Name | Operation | Operand | 

IFLOAT |DC |DE+4'+46,-3,729,+473' I 



Decimal Constants — P and Z: A decimal 
constant is written as a signed or unsigned 
decimal value. If the sign is omitted, a 
plus sign is assumed. The decimal point 



may be written wherever desired or may be 
omitted. Scaling and exponent modifiers 
may not be specified for decimal constants. 
The maximum length of a decimal constant is 
16 bytes. No word boundary alignment is 
performed. 

The placement of a decimal point in the 
definition does not affect the assembly of 
the constant in any way, because, unlike 
fixed- point and floating-point constants, a 
decimal constant is not converted to its 
binary equivalent. The fact that a decimal 
constant is an integer, a fraction, or a 
mixed number is not pertinent to its 
generation. Furthermore, the decimal point 
is not assembled into the constant. The 
programmer may determine proper decimal 
point alignment either by defining his data 
so that the point is aligned or by select- 
ing machine-instructions that will operate 
on the data properly (i.e., shift it for 
purposes of alignment) . 

If zoned decimal format is specified 
(Z), each decimal digit is translated into 
one byte. The translation is done accord- 
ing to the character set shown in Appendix 
A, The rightmost byte contains the sign as 
well as the rightmost digit. For packed 
decimal format (P), each pair of decimal 
digits is translated into one byte. The 
rightmost digit and the sign are translated 
into the rightmost byte. The bit configu- 
ration for the digits is identical to the 
configurations for the hexadecimal digits 
0-9 as shown in Section 3 under 
"Hexadecimal Self-Defining Value." For 
both packed and zoned decimals, a plus sign 
is translated into the hexadecimal digit C, 
and a minus sign into the digit D. 

If an even number of packed decimal 
digits is specified, one digit will be left 
unpaired, because the rightmost digit is 
paired with the sign. Therefore, in the 
leftmost byte, the leftmost four bits will 
be set to zeros and the rightmost four bits 
will contain the odd (first) digit. 

If no length modifier is given, the 
implied length for either constant is the 
number of bytes the constant occupies 
(taking into account the format, sign, and 
possible addition of zero bits for packed 
decimals). If a length modifier is given, 
the constant is handled as follows: 

1. If the constant requires fewer bytes 
than the length specifies, the neces- 
sary number of bytes is added to the 
left. For zoned decimal format, the 
decimal digit zero is placed in each 
added byte. For packed decimals, the 
bits of each added byte are set to 
zero. 

2. If the constant requires more bytes 
than the length specifies, the neces- 
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sary number of leftmost digits or 
pairs of digits is dropped!, depending 
on which format is specified. 



Examples of decimal constant definitions 
follow. 



r T ^T 

I Name | Operation {Operand 



DC 
DC 
DC 
DC 



|P'+1.25' 
|2«-543* 
|Z*79.68' 
JPL3*79.68* 

..X .. 



The following statement specifies three 
packed decimal constants. The llength modi- 
fier applies to each constant ijn the first 
operand (i.e., to each packed decimal 
constant) . 



I T -T ' 1 

[Name | Operation! Operand | 

|DECIMALS|DC | PL8' +25. 8 ,-3874 ,+2. 3' | 

L J. .J. ^ J 



The last example illustrates the use of 
a packed decimal literal. 



r T T -' T 

I Name | Operation | Operand | 

I |UNPK |OUTAREA,=PIi2'+25* | 

I X i. * , J 



ADDRESS CONSTANTS: An address constant is 
a storage address that is translated into a 
constant. Address constants are normally 
used for initializing base registers to 
facilitate the addressing of storage. 
Furthermore, they provide the means of 
communicating between control sections of a 
multisection program. However, storage 
addressing and control section communi- 
cation are also dependent on the use of the 
USING assembler instruction and the loading 
of registers. Coding examples that illus- 
trate these considerations are provided in 
Section 3 under "Programming with the Using 
Instruction." 

An address constant, unlike other types 
of constants, is enclosed in parentheses. 
If two or more address constants are speci- 
fied in a statement, they are separated by 
commas, and the entire sequence is enclosed 
by parentheses. There are four types of 
address constants: A, Y, S, and V. 



Complex Relocatable Expressions: A complex 
relocatable expression can only be used in 
an A-type or Y-type address constant. 
These expressions contain two or more 
unpaired relocatable terms and/or a nega- 
tive relocatable term in addition to any 
absolute or paired relocatable terms that 
may be present. In contrast to relocatable 
expressions, complex relocatable expres- 
sions may represent negative values. A 
complex relocatable expression might con- 
sist of external symbols (which cannot be 
paired) and designate an address in an 
independent assembly that is to be linked 
and loaded with the assembly containing the 
address constant. 

The assembler partially evaluates the 
expression but its final value is deter- 
mined when the referenced control sections 
are loaded. Complex relocatable expres- 
sions can be used to determine the distance 
between two control sections after they are 
loaded into main storage. 

A- Type Address Constant; This constant is 
specified as an absolute, relocatable, or 
complex relocatable expression. (Remember 
that an expression may be single term or 
multiterm. ) The value of the expression is 
calculated to 32 bits as explained in Sec- 
tion 2, with one exception: the maximum 
value of the expression may be 2 3i— i. The 
value is then truncated, if necessary, to 
the specified or implied length of the 
field and assembled into the rightmost bits 
of the field. The implied length of an 
A-type constant is four bytes and alignment 
is to a full-word boundary unless a length 
is specified, in which case no alignment 
will occur. The length that may be speci- 
fied depends on the type of expression used 
for the constant; a length of 1-4 bytes may 
be used for an absolute expression, while a 
length of 3 or 4 bytes may be used for a 
relocatable or comi)lex relocatable expres- 
sion. 

In the following examples, the field 
generated from the statement named ACONST 
contains four constants, each of which 
occupies four bytes. Note that there is a 
Location Counter reference in one. The 
value of the Location Counter will be the 
address of the first byte allocated to the 
fourth constant. The second statement 
shows the same set of constants specified 
as literals (i.e., address constant 
literals) . 



r r r t 1 

I Name | Operation | Operand | | 
^ ^ 1 1 ^ 

I ACONST I DC I A (108, LOOP, | X | 
I 1 |END-STRT,*+4096) | | 
I |LM I 4, 7, =A (108, LOOP, \ X | 
I I |END-STRT,*+4096) | | 
t J. L L J 
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Note ; When the Location Counter ref- 
erence occurs in a literal, as in the LM 
instruction above, the value of the Loca- 
tion Counter is the address of the first 
byte of the instruction. 

Y-type Address Constant: A Y-type address 
constant has much in common with the A-type 
constant. It, too, is specified as an 
absolute, relocatable, or complex relocata- 
ble expression. The value of the expres- 
sion is also calculated to 32 bits as 
explained in Section 2. However, the maxi- 
mum value of the expression may be only 
2^'-l. The value is then truncated, if 
necessary, to the specified or implied 
length of the field and assembled into the 
rightmost bits of the field. The implied 
length of a Y-type constant is two bytes 
and alignment is to a half-word boundary 
unless a length is specified, in which case 
no alignment occurs. The maximum length of 
a Y-type address constant is two bytes. If 
length specification is used, a length of 
two bytes may be designated for a relocata- 
ble or complex expression and 1 or 2 bytes 
for an absolute expression. 

Warning; Specification of relocatable 
Y-type address constants should be avoided 
in programs destined to be executed on 
machines having more than 32,767 bytes of 
storage capacity. In any case Y-type 
address constants should not be used in 
programs to be executed under Basic Operat- 
ing System/360 control, 

S-Type Address Constant: The S-type 
address constant is used to store an 
address in base-displacement form. 

The constant may be specified in two 
ways: 

1. As an absolute or relocatable expres- 
sion, e.g., S(BETA). 

2. As two absolute expressions, the first 
of which represents the displacement 
value and the second, the base reg- 
ister, e.g., S(400(13)). 

The address value represented by the 
expression in (1) will be broken down by 
the assembler into the proper base register 
and displacement value. An S-type constant 
is assembled as a half word and aligned on 
a half-word boundary. The leftmost four 
bits of the assembled constant represents 
the base register designation, the remain- 
ing 12 bits the displacement value. 

If length specification is used, only 
two bytes may be specified. S-type address 
constants may not be specified as literals. 

V-Type Address Constant; This constant is 
used to reserve storage for the address of 
an external symbol that is used for effect- 



ing branches to other programs. The con- 
stant may not be used for external data 
references. The constant is specified as 
one relocatable symbol , which need not be 
identified by an EXTRN statement. Whatever 
symbol is used is assumed to be an external 
symbol by virtue of the fact that it is 
supplied in a V-type address constant. 

Note that specifying a symbol as the 
operand of a V-type constant does not con- 
stitute a definition of the symbol for this 
assembly. The implied length of a V-type 
address constant is four bytes, and bound- 
ary alignment is to a full word. A length 
modifier may be used to specify a length of 
either three or four bytes, in which case 
no such boundary alignment occurs. In the 
following example, 12 bytes will be res- 
erved, because there are three symbols. 
The value of each assembled constant will 
be zero until the program is loaded. 



r r ~T 1 

|Name | Operation ] Operand j 

IVCONST I DC I V (SORT, MERGE, CALC) | 

L 1 X J 



DS — DEFINE STORAGE 



The DS instruction is used to reserve areas 
of storage and to assign names to those 
areas. The typical form of the DC state- 
ment is : 



I Name j Operation j Operand j 

I A symbol |DS jone operand 
I or I I written in the 

I not used | | format described 

I in the following 

I text 



The format of the DS operand is identi- 
cal to that of the DC operand; exactly the 
same subfields are employed and are written 
in exactly the same sequence as they are in 
the DC operand. Although the formats are 
identical, there are two differences in the 
specification of subfields. They are: 

1. The specification of data (subfield 4) 
is optional in a DS operand, but it is 
mandatory in a DC operand. 

2. The maximum length that may be speci- 
fied for character (C) and hexadecimal 
(X) field types is 65,535 bytes rather 
than 256 bytes. 
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If a DS operand specifies a constant in 
subfield k, and no length is specified in 
subfield 3, the assembler deteifmines the 
length of the data and reserve^ the 
appropriate amount of storage- It does not 
assemble the constant . The ability to 
specify data and have the asseitibler calcu- 
late the storage area that would be 
required for such data is a convenience to 
the programmer. If he knows the general 
format of the data that will b0 placed in 
the storage area during program execution, 
all he needs to do is show it as the fourth 
subfield in a DS operand. The assembler 
then determines th€» correct amount of stor- 
age to be reserved, thus relieving the 
programmer of length considerations. 

If the DS instruction is named by a 
symbol, its value attribute is the location 
of the leftmost byte of the reserved area. 
The length attribute of the symbol is det- 
ermined in the same manner as for a DC. 
Any positioning required for aligning the 
storage area to the proper type of boundary 
is done before the address value is deter- 
mined. Bytes skipped for alignment are not 
set to zero. 



fied for the C, X, P, Z, or B field types, 
or else the data must be specified (as the 
fourth subfield), so that the assembler can 
calculate the length. 

To define four 10-byte fields and one 
10 0-byte field, the respective DS state- 
ments might be as follows: 



r T T — 1 

j Name | Operation | Operand | 

I FIELD IDS lUCLlO | 

I AREA IDS ICLIOO | 

L X J J 



Although FIELD might have been specified 
as one 40-byte field, the preceding defini- 
tion has the advantage of providing FIELD 
with a length attribute of 10. This would 
be pertinent when using FIELD as a SS 
machine-instruction operand. 

Additional examples of DS statements are 
shown below: 



Each field type (e.g., hexadecimal, 
character, floating-point) is associated 
with certain characteristics (these are 
summarized in Appendix F) . The associated 
characteristics will determine which field- 
type code the programmer selects for the DS 
operand and what other information he adds, 
notably a length SE)ecif ication or a 
duplication factor. For example, the E 
floating-point field and the F fixed-point 
field both have an implied length of four 
bytes. The leftmost byte is aligned to a 
full-word boundary. Thus, either code 
could be specified if it were desired to 
reserve four bytes of storage aligned to a 
full-word boundary. To obtain a length of 
eight bytes, one could specify either the E 
or F field type with a length modifier of 
eight. However, a duplication factor would 
have to be used to reserve a larger area, 
because the rtaximum length specification 
for either type is eight bytes. Note also 
that specifying length would cancel any 
special boundary alignment. 

In contrast, packed and zoned decimal (P 
and Z) , character (C), hexadecimal (X), and 
binary (B) fields have an implied length of 
one byte. Any of these codes, if used, 
would have to be accompanied by a length 
modifier, unless just one byte is to be 
reserved. Although no alignment occurs, 
the use of C and X field types permits 
greater latitude in length specpif ications, 
the maximum for either type being 65,535 
bytes. (Note that this differs from the 
maximum for these types in a DC instruc- 
tion. ) Unless a field of one byte is 
desired, either the length must be speci- 



r T T 1 

I Name j Operation) Operand | 



I ONE 



ITWO 



THREE 



FOUR 



I FIVE 



L 




CL80(one 8 0- byte field, 

length attribute of 80 
80C(80 one-byte fields, 

length attribute of one 
6F(six full words, length 

attribute of four) 
D(one double word, length 

attribute of eight) 
i*H(four half-words, 

length attribute of 

two) 



Note : A DS statement causes the storage 
area to be reserved but not set to zeros. 
No assumption should be made as to the 
contents of the reserved area. 



Special Uses of the Duplication Factor 



FORCING ALIGNMENT; The Location Counter 
can be forced to a double-word, full-word, 
or half-word boundary by using the 
appropriate field type (e.g., D, F, or H) 
with a duplication factor of zero. This 
method may be used to obtain boundary 
alignment that otherwise would not be pro- 
vided- For example, the following state- 
ments would set the Location Counter to the 
next double-word boundary and then reserve 
storage space for a 128-byte field (whose 
leftmost byte would be on a double-word 
boundary) . 
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r T T 1 

I Name | Operation | Operand | 

I IDS lOD I 

I AREA JDS JCL128 | 



DEFINING FIEIi>S OF AN AREA; A DS instruc- 
tion with a duplication factor of zero can 
be used to assign a name to an area of 
storage without actually reserving the 
area. Additional DS and/or DC instructions 
may then be used to reserve the area and 
assign names to fields within the area (and 
generate constants if DC is used) . 



For example, assume that 80- character 
records are to be read into an area for 
processing and that each record has the 
following format: 



Positions 5-10 
Positions 11-30 
Positions 31-36 
Positions U7-54 
Positions 55-6 2 



Payroll Number 

Employee Name 

Date 

Gross Wages 

Withholding Tax 



The following example illustrates how DS 
instructions might be used to assign a name 
to the record area, then define the fields 
of the area and allocate the storage for 
them. Note that the first statement names 
the entire area by defining the symbol 
RDAREA; the statement gives RDAREA a length 
attribute of 80 bytes, but does not reserve 
any storage. Similarly, the fifth state- 
ment names a 6- byte area by defining the 
symbol DATE; the three subsequent state- 
ments actually define the fields of DATE 
and allocate storage for them. The second, 
ninth, and last statements are used for 
spacing purposes and, therefore, are not 
named. 



CCW — DEFINE CHANNEL COMMAND WORD 



The CCW instruction provides a convenient 
way to define and generate an eight-byte 
channel command word aligned at a double- 
word boundary. The internal machine format 
of a channel command word is shown in Table 
5-1. The typical form of the CCW 
instruction statement is: 



j Name | Operati on j Operand 






A symbol 
or not 
used 



L 



CCW jFour operands, 

{separated by commas, 

I specifying the con- 

1 tents of the channel 

I command word in 

I the format 

I described in the 

I following text 



All four operands must appear. They are 
written, from left to right, as follows: 

1. An absolute expression that specifies 
the command code. This expression's 
value is right- justified in byte 1. 

2. An absolute or relocatable expression 
specifying the data address. The 
value of this expression is right- 
justified in bytes 2-4. 

3. An absolute expression that specifies 
the flags for bits 32-36 and zeros for 
bits 37-39. The value of this 
expression is right- justified in byte 
5. (Byte 6 is set to zero.) 

U. An absolute expression that specifies 
the count. The value of this expres- 
sion is right- justified in bytes 7-8. 

The following is an example of a CCW 
statement: 



r — T T 

I Name | Operation (Operand 



1 RDAREA 


DS 


10CL80 


1 


DS 


|CL4 


j PAYNO 


DS 


|CL6 


1 NAME 


DS 


|CL20 


IDATE 


DS 


I0CL6 


jDAY 


DS 


|CL2 


1 MONTH 


DS 


|CL2 


1 YEAR 


DS 


1CL2 


1 


DS 


ICLIO 


1 GROSS 


DS 


|CL8 


1 FEDTAX 


DS 


|CL8 


1 

L , J 


DS 

L 


|CL18 

„x 



j Name [Operation | Operand j 

^ ^+ + ^ 

I JCCW |2,READAREA,X'48' ,80 | 

L X L J 



Note that the form of the third operand 
sets bits 37-39 to zero, as required. The 
bit pattern of this operand is as follows: 



32-35 
0100 



36-39 
1000 



If there is a symbol in the name entry 
of the CCW instruction, it is assigned the 
address value of the leftmost byte of the 
channel command word. The length attribute 
of the symbol is eight. 
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Table 5-1. Channel Coniniand Wotd 
I Byte I Bits I Uscige 



1 


0-7 


Cowniand code 


2-U 


8-31 


Data address 


5 


32-36 


Flags 




37-39 


Must be zero 


6 


ao-u7 


Set to zero 


7-8 


«48-63 


Count 



1 



LISTING CONTROL INSTRUCTIONS 



number of operand characters. The contents 
of the operand field are printed at the top 
of each page of the assembly listing. 



A program may contain more than one 
TITLE statement. Each TITLE statement 
provides the heading for pages in the 
assembly listing that follow it, until 
another TITLE statement is encountered. 
Each TITLE statement encountered after the 
first one causes the listing to be advanced 
to a new page ( before the heading is 
printed) . 



The listing control instructions are used 
to identify an assembly listing and assem- 
bly output cards, to provide blank lines in 
an assembly listing, and to designate how 
much detail is to be included in an assem- 
bly listing. In no case are instructions 
or constants generated in the object pro- 
gram. Listing control statements except 
PRINT are never printed. 



For example, if the following statement 
is the first TITLE statement to appear in a 
program: 



r T T 1 

I Name | Operation | Operand | 

IPGMI ITITLE I 'FIRST HEADING* | 

L J JL J 



TITLE — IDENTIFY ASSEMBLY OUTPUT 



The TITLE instruction enables the program- 
mer to identify the assembly listing and 
assembly output cards. The typical form of 
the TITLE instruction statement is as fol- 
lows: 



then PGMl is punched into all of the output 
cards (columns 73-76) and this heading 
appears at the top of each page: FIRST 
HEADING. 

If the following statement occurs later 
in the same program: 



r T -T 

I Name | Operation | Operand 

f 



I Name 
I or 
jNot 
I used 



TITLE jOne to 100 char- 

jacters, enclosed in 
i single apostrophes 



The name entry may contain a name of 
from one to four alphabetic or numeric 
characters in any combination. The con- 
tents of the name entry are punched into 
columns 73-76 of all the output cards for 
the program except those produced by the 
PUNCH and REPRO assembler instructions. 
Only the first TITLE statement in a program 
may have a name in the name entry. The 
name field of all subsequent TITLE state- 
ments must be blank. 



r 1 T 1 

)Name | Operation [Operand | 

|. 1 1 ^ 

I ITITLE I 'A NEW HEADING' | 

L X J J 



then, PGMl is still punched into the output 
cards, but each following page begins with 
the heading: A NEW HEADING. 

Note : The sequence number of the cards 
in the output deck is contained in columns 
77-80, except those produced by the PUNCH 
and REPRO assembler instructions. 



EJECT — START NEW PAGE 



The operand field may contain up to 100 
characters enclosed in apostrophes. Any 
ampersands or apostrophes enclosed within 
the surrounding apostrophes must be rep- 
resented by two ampersands or apostrophes. 
However, both ampersands and apostrophes 
are printed and are counted in the total 



The EJECT instruction causes the next line 
of the listing to appear at the top of a 
new page. This instruction provides a 
convenient way to separate routines in the 
program listing. The typical form of the 
EJECT instruction statement is as follows: 
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JName | Operation j Operand 

I Not I EJECT jNot used; must not 
jused I I be present 



One to three of the following operands 
are used: 



-\ 



If the next line of the listing would 
appear at the top of a new page without the 
EJECT instruction, the EJECT instruction 
has no immediate effect. If one or more 
EJECT statements appear after the first 
EJECT, one or more pages are skipped. 



SPACE — SPACE LISTING 



The SPACE instruction is used to insert one 
or more blank lines in the listing. The 
typical form of the SPACE instruction 
statement is as follows: 



r T T 1 

I Name | Operation | Operand | 

I Not I SPACE I A decimal value | 
I used I I or not used j 



A decimal value is used to specify the 
number of blank lines to be inserted in the 
assembly listing. A blank operand causes 
one blank line to be inserted. If this 
value exceeds the number of lines remaining 
on the listing page, the statement will 
have the same effect as an EJECT statement. 



ON 

or 
OFF 

GEN 

or 

NOGEN 



DATA 

or 

NODATA 



A listing is printed. 

No listing is printed. 

All statements generated by 
macro-instructions are printed. 

Statements generated by macro- 
instructions are not printed, 
except MNOTE messages (with a 
severity code) which print 
regardless of NOGEN. However, 
the macro-instruction itself 
will appear in the listing. 

Constants are printed out in 
full in the listing. 

- Only the leftmost eight bytes 
(16 hexadecimal digits) are 
printed. 



A program may contain any number of 
PRINT statements. The conditions set by a 
PRINT statement are in effect until another 
PRINT statement is encountered. 

If an operand is canitted, it is assumed 
to be unchanged and continues according to 
its last specification. 

When OFF is specified, GEN and DATA have 
no effect. When NOGEN is specified, DATA 
has no effect for generated constants. 

Until the first PRINT statement (if any) 
is encountered, the following is assumed: 



j Name | Operation j Operand | 

I I PRINT ION, NOD ATA, GEN j 

L L L J 



PRINT — PRINT OPTIONAL DATA 



For example, if the statement: 



The PRINT instruction controls the content 
of the assembly listing. The operands 
determine printing of: a listing, state- 
ments generated by macro - instructions, 
and constants. The typical form of the 
PRINT instruction is: 



r T 1 1 

I Name | Operation | Operand | 

|. 1 + ^ 

I Not I PRINT I One to three operands) 
I used j I I 



r T r 1 

[Name |Operation j Operand | 

^ ^ + ^ 

I |DC |XL256'00' | 

L J. J J 

appears in a program, 256 bytes of zeros 
are assembled. If the statement: 



r T T 1 

I Name | Operation | Operand | 

^ + ^ ^ 

I I PRINT I DATA | 



52 



is the last PRINT statement to appear 
before the DC statement, all 256 bytes of 
zeros are printed in the assembly listing. 
However, if there are no previous PRINT 
statements, or: 



source program and may be used only once. 
The form of the ICTL instruction statement 
is as follows: 



r T ■ — T -"• 1 

I Name | Operation | Operand j 

^ 1 + ^ 

j j PRINT JNODATA | 

t X .X J 



r T T 1 

I Name j Operation | Operand | 

^ + 1 ^ 

I Not used, I ICTL I 1-3 decimal j 
{must not I I values of the j 

j be present j j form b,e,c | 



is the last PRINT statement to appear 
before the DC statement, only eight bytes 
of zeros are printed in the assembly list- 
ing. 

Whenever an operand is omitted, it is 
assumed to be unchanged and continues 
according to its last specification. Its 
omission must be indicated by a comma. 

The hierarchy of PRINT control state- 
ments is : 

1. ON, OFF 

2. GEN, NOGEN 

3. DATA, NOD ATA 

Thus, with the following statement nothing 
would be printed. 



r T r • 1 

I Name [Operation | Operand | 

I 1 PRINT |off,data,g|;n I 

L ± .X • , J 



PROGRAM CONTROL INSTRUCTIONS 



The program control instructions are used 
to specify the end of an assembly, to set 
the Location Counter to a value, to insert 
previously written coding in the program, 
to specify the placement of literals in 
storage, to check the sequence of input 
cards, to indicate statement format, and to 
punch a card. Except for the CNOP and COPY 
instructions, none of these assembler 
instructions generate instructions or con- 
stants in the object program. 



Operand b specifies the begin column of 
the source statement. It must always be 
specified, and must be from 1-40, inclu- 
sive. Operand e specifies the end column 
of the source statement. The end column, 
when specified, must be from 41-80, inclu- 
sive; when not specified, it is assumed to 
be 71. The column after the end column is 
used to indicate whether the next card is a 
continuation card. Operand c specifies the 
continue column of the source statement. 
The continue column, when specified, must 
be from 2-40 and must be greater than b. 
If the continue column is not specified, or 
if column 80 is specified as the end 
column, the assembler assumes that there 
are no continuation cards, and all state- 
ments must be contained on a single card- 
The operand forms b, ,c and b, are invalid. 

If no ICTL statement is used in the 
source program, the assembler assumes that 
1, 71, and 16 are the begin, end, and con- 
tinue columns, respectively. 

The next example designates the begin 
column as column 25. Since the end column 
is not specified, it is assumed to be 
column 71. No continuation cards are rec- 
ognized because the continue column is not 
specified. 



, P P ^ 

I Name | Operation J Operand | 

J. + ^- ^ 

I IICTL 1 25 I 

L a J. J 



ISEQ — INPUT SEQUENCE CHECKING 



ICTL — INPUT FORMAT CONTROL 



The ICTL instruction allows the programmer 
to alter the normal format of his source 
program statements,. The ICTL statement 
must precede all other statements in the 



The ISEQ instruction is used to check the 
sequence of input cards. The typical form 
of the ISEQ instruction statement is as 
follows : 
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JNaroe | Operation j Operand 

I Not used, I ISEQ j Two decimal 

I must not I j values of the 

I be present | | form l,r, or 

I j j not used 

L J i. 



The operands 1 and r, respectively, 
specify the leftmost and rightmost coliamns 
of the field in the input cards to be 
checked. Operand r must be equal to or 
greater than operand 1. Columns to be 
checked must not be between the "begin" and 
"end" columns. 

Sequence checking begins with the first 
card following the ISEQ statement. Compar- 
ison of adjacent cards makes use of the 
eight-bit internal collating sequence. 
System macros and COPYed code are not 
sequence checked. 

An ISEQ statement with a blank operand 
terminates the operation. Checking may be 
resumed with another ISEQ statement. 

Sequence checking is only performed on 
statements contained in the source program. 
Statements inserted by the COPY 
assembler-instruction or generated by a 
macro- instruct ion are not checked for 
sequence. 



PUNCH — PUNCH A CARD 



the operand of a PUNCH statement other than 
causing it to be punched in a card. For 
each apostrophe or ampersand desired in the 
operand, two apostrophes or ampersands must 
be written. The two apostrophes or amper- 
sands are reduced to a single apostrophe or 
ampersand. However, they count as only one 
character in the operand. 

PUNCH statements may occur anywhere 
within a program, except before macro- 
definitions. They may occur within a 
macro- definition but not between a MEND 
statement and the beginning of the next 
macro. If a PUNCH statement occurs before 
the first control section, the resultant 
card will precede all other cards in the 
object program card deck; otherwise the 
card will be punched in place. 



REPRO — REPRODUCE FOLLOWING CARD 



The REPRO assembler- instruction causes data 
on the following statement line to be 
punched into a card. The data is not proc- 
essed; it is punched in a card and no sub- 
stitution is performed for variable sym- 
bols. One REPRO instruction produces one 
punched card. The REPRO instruction may 
not appear before a macro- definition. 

REPRO statements that occur before all 
statements composing the first or only 
control section will punch cards which 
precede all cards of the object deck. The 
form is: 



The PUNCH assembler- instruction causes the 
data in the operand to be punched into a 
card. One PUNCH statement produces one 
punched card. As many PUNCH statements may 
be used as are necessary. The typical form 
is: 



r T T • 1 

jName | Operation | Operand j 

iNot I REPRO I Not used, should | 
jused I I not be present j 

L ± L J 



r T T T 

I Name j Operation ) Operand | 

I Not I PUNCH |1 to 80 characters | 
I used I I enclosed in | 

I I I apostrophes j 



The line to be reproduced may contain 
any combination of up to 80 characters. 
Characters may be entered starting in 
column 1 and continue through column 80 of 
the line. Column 1 of the line corresponds 
to column 1 of the card to be punched. 



Using character representation, the 
operand is written as a string of up to 80 
characters enclosed in apostrophes . All 
characters, including blank, are valid. 
The position immediately to the right of 
the left apostrophe is regarded as column 
one of the card to be punched. The assem- 
bly program does not process the data in 



ORG — SET LOCATION COUNTER 



The ORG instruction is used to alter the 
setting of the Location Counter for the 
current control section. The typical form 
of the ORG instruction statement is: 



5H 



I 1 T— • 1 

I Name | Operation | Operand | 

^ 1 1 ^ 

I Not I ORG I A relocatable ex- | 
I used I jpression or not used | 

i J J. J 



Any symbols in the expression roust have 
been previously defined. The unpaired 
relocatable symbol must be defined in the 
same control section in which the ORG 
statement appears. 

The Location Counter is set to the value 
of the expression in the operand. If the 
operand is omitted, the Location Counter is 
set to a location that is one fc)yte higher 
than the maximum location assigned for the 
control section up to this point. 

An ORG statement must not be used to 
specify a location below the beginning of 
the control section in which it appears. 
For example, the statement: 

r T r " ' 1 

I Name {Operation [Operand j 

^ 1 ^ _ ^ 

I I ORG |*-500 I 

1 X J. J 



is invalid if it appears less than 500 
bytes from the beginning of the current 
control section. 

If it is desired to reset the Location 
Counter to a value that is one byte beyond 
the highest location yet assigned (in the 
control section) , the following statement 
would be used: 



literals follow the LTORG statement, align- 
ment of the next instruction will occur. 
Bytes skipped are not zeroed. The typical 
form of the LTORG instruction statement is: 



r T T 1 

I Name | Operation 1 Operand | 

|. + 1 ^ 

I A symbol I LTORG |Not used, should j 
I or not j I not be present | 

I used I I I 

L ± L J 



The symbol represents the address of the 
first byte of the literal pool. It has a 
length attribute of one. 

A LTORG statement is not legal within a 
dummy section or blank common. 



Special Addressing Consideration 



Any literals used after the last LTORG 
statement in a program are placed at the 
end of the first control section. If there 
are no LTORG statements in a program, all 
literals used in the program are placed at 
the end of the first control section. In 
these circumstances the programmer must 
ensure that the first control section is 
always addressable. This means that the 
base address register for the first control 
section should not he changed through usage 
in subsequent control sections. 



r T "T 1 

I Name |Operation | Operand J 

|. + + ^ 

I lORG I I 

t X X J 



If previous ORG statements have reduced 
the Location Counter for the purpose of 
redefining a portion of the current control 
section, an ORG statement with an omitted 
operand can then be used to terminate the 
effects of such statements and restore the 
Location Counter to its highest setting. 



LTORG — BEGIN LITERAL POOL 



The LTORG instruction causes all literals 
thus far encountered in the source program 
to be assembled at appropriate boundaries 
starting at the first double-word boundary 
following the LTORG statement.. If no 



CNOP — CONDITIONAL NO OPERATION 



The CNOP instruction allows the programmer 
to align an instruction at a specific word 
boundary. If any bytes must be skipped in 
order to align the instruction properly, 
the assembler insures an unbroken instruc- 
tion flow by generating no-operation 
instructions. This facility is useful in 
creating calling sequences consisting of a 
linkage to a subroutine followed by parame- 
ters such as channel command words (CCW). 

The CNOP instruction insures the align- 
ment of the Location Counter setting to a 
half-word, word, or double-word boundary. 
If the Location Counter is already properly 
aligned, the CNOP instruction has no 
effect. If the specified alignment 
requires the Location Counter to be incre- 
mented, one to three no-operation instruc- 
tions are generated, each of which uses two 
bytes. 
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Double Word 

T 



1 Word I word | 

I Half word j Half word 1 Half word | Half word | 

I Byte j Byte j Byte j Byte | Byte | Byte | Byte | Bytej 
I 



0,4 
0,8 



2,U 
2,8 



0,4 
4,8 



2,4 
6,8 



Figure 5-2. CNOP Alignment 



The typical form of the CNOP instruction 
statement is as follows: 



I Name | Operation 

I Not I CNOP 
fused I 






j Operand 
.+ 

I Two absolute 
j expressions of 
I the form b,w 



I Name [Operation 
k 



CNOP 
BALR 



L 



j Operand 

■+ 

|0,8 
I 2, 14 



— 1 
I 

-H 
I 
I 



has no effect. However, this sequence; 






Any symbols used in the expressions in 
the operand field must have been previously 
defined. 



r T T • 1 

[Name [Operation | Operand j 

^ 1 + „ ^ 

i 1 CNOP I 6 , 8 j 

I I BALR 1 2, 14 1 

L J. _, L J 



Operand b specifies at which byte in a 
word or double word the Location Counter is 
to be set; b can be 0, 2, 4, or 6, Operand 
w specifies whether byte b is in a word 
(w=4) or double word (w=8). The following 
pairs of b and w are valid: 



causes three branch-on-conditions 
(no-operations) to be generated, thus 
aligning the BALR instruction at the last 
half-word in a double word as follows: 



b,w Specifies 

0,4 Beginning of a word 

2,4 Middle of a word 

0,8 Beginning of a double word 

2,8 Second half word of a double word 

4,8 Middle (third half word) of a dou- 
ble word 

6,8 Fourth half word of a double word 

Figure 5-2 shows the position in a dou- 
ble word that each of these pairs speci- 
fies. Note that both 0,4 and 2,4 specify 
two locations in a double word. 



[Name [Operation [Operand [ 

[ jBCR [0,0 I 

[ [ BCR [0,0 [ 

[ [BCR [0,0 I 

[ [BALR [2,14 I 



After the BALR instruction is generated, 
the Location Counter is at a double-word 
boundary, thereby insuring an unbroken 
instruction flow. 



Assume that the Location Counter is 
currently aligned at a double-word bounda- 
ry. Then the CNOP instruction in this 
sequence: 



Note : If the location counter is on an 
odd- numbered byte- boundary when a CNOP 
instruction is encountered, normal align- 
ment occurs before the CNOP is processed. 
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COPY — COPY PREDEFINED SOURCE CODING 



END — END ASSEMBLY 



The COPY instruction obtains source- 
language coding from a system library 
(Assembler source statement library) and 
includes it in the program currently being 
assembled. The form of the COPY 
instruction statement is as follows: 



The END instruction terminates the assembly 
of a program. It may also designate a 
point in the program or in a separately 
assembled program to which control may be 
transferred after the program is loaded. 
The END instruction must always be the last 
statement in the source program. 



I T r • ' 1 

I Name j Operation ) Operand | 

I Not used, j COPY I One symbol ] 
jmust not j I i 

I be present | j j 

I J. J • . J 



The operand is a symbol that identifies 
the section of coding to be copied. 

The assembler inserts the requested 
coding immediately after the COPY statement 
is encountered. The requested coding may 
not contain another COPY statement. 



The typical form of the END instruction 
statement is as follows: 



r r r 1 

{Name j Operation | Operand | 
f 1 + ^ 

I A sequence | END | A relocatable j 
i symbol or j | expression or | 

jnot present) | not present j 

i L L J 

The operand specifies the point to which 
control is transferred when loading is 
complete. For example: 



If identical COPY statements are encoun- 
tered, the coding they request is brought 
into the program each time. 

COPYed text is always in the normal 
format and is not governed by ICTL usage. 
See copy Statements in Section 7 for furth- 
er information. The procedure for placing 
source language coding in the system 
library is described in the System Control 
and System Service Programs publication 
listed in the Preface. 



I Name | Operation | Operand 

NAME I CSECT 1 

AREA IDS I 5 OF 

BEGIN I BALR | 2 , 

I USING I ♦ , 2 

i - I 



END 



BEGIN 
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PART 3 — CONDITIONAL ASSEMBLY AND MACRO FACILITIES IN THE ASSEMBLER LANGUAGE 



SECTION 6: INTRODUCTION TO THE MACRO 
FACILITIES 



The Basic Operating System/360 conditional 
assembly and macro facilities are part of 
the Basic Operating System/360 assembler 
language. 

Conditional assembly allows one to spec- 
ify assembler language statements which may 
or may not be assembled, depending upon 
conditions evaluated at assembly time. 
Conditional assembly statements are used to 
define, set, change, and test values during 
the course of the assembly itself. 

The conditional assembly instructions 
may be used to vary the sequence of state- 
ments generated for each occurrence of a 
macro-instruction. Conditional assembly 
instructions may also be used outside 
macro-definitions, i.e., among the assem- 
bler language statements in the program. 

The macro facilities provide the pro- 
grammer with a convenient way to write a 
macro-definition that can be used to gener- 
ate a desired sequence of machine instruc- 
tions and certain assembler instructions 
many times in one or more programs. 

This macro-definition is written only 
once, and a single statement, a macro- 
instruction statement, is written each time 
a programmer wants to generate the desired 
sequence of statements. 

This facility simplifies the coding of 
programs, reduces the chance of programming 
errors, and ensures that standard sequences 
of statements are used to accomplish 
desired functions. 



THE MACRO- INSTRUCT ION STATEMENT 



A macro- instruction statement (also called 
a macro-instruction) is a source program 
statement used to provide information for 
generating machine and assembler instruc- 
tions from a macro-definition. The gener- 
ated instructions are source statements 
which are then processed by the assembler 
program. 

Three types of macro-instructions may be 
written. Each type has a different form of 
operand. They are: 



1. Positional ( Sections 7 and JB) . 

2. Keyword ( Section 10 ) . 

3. Mixed-mode ( Section 10 ). 

Positional macro-instruction operands 
are written in a fixed order. 

Keyword macro- instruction operands can 
be written in any order. 

Mixed- mode macro- in struct ion operands 
are a combination of both positional and 
keyword operands. That is, certain operand 
entries (positional) must be written in a 
fixed order; other operand entries 
(keyword) can be specified in any order. 



THE MACRO- DEFINITION 



Before a macro-instruction can be assem- 
bled, a macro-definition must be available 
to the assembler. 

A macro-definition is a set of state- 
ments that provide the assembler with: 

1. The name entry, mnemonic operation 
code, and the form of the macro- 
instruction operand, and 

2. The sequence of statements the 
assembler uses when the macro- 
instruction appears in the source 
program. 

Every macro-definition consists of 
macro-definition header statement, a macro- 
instruction prototype statement, a sequence 
of model statements, COPY statements, MEXIT 
or MNOTE instructions, and a macro- 
definition trailer statement. 

The macro-definition header and trailer 
statements denote the beginning and end, 
respectively, of a macro- definition. 

The macro- instruction prototype 
statement specifies the name entry, mnemon- 
ic operation code, and the form of the 
macro- instruction operand. 

The model statements contained in a 
macro-definition may be used by the assem- 
bler to generate machine instructions and 
certain assembler instructions that replace 
each occurrence of the macro- instruction. 
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The COPY statements may be used to copy 
model statements, MEXIT instructions, and 
MNOTE instructions from a system library 
(Assembler source statement library) into a 
macro-definition. 



The MEXIT instruction can be used to 
terminate processing of a macro-definition. 



The MNOTE instruction can be used to 
generate a message. 



Types of Variable Symbols 



There are three types of variable symbols: 
symbolic parameters, system variable sym- 
bols, and SET symbols. The SET symbols are 
further broken down into SETA symbols, SETB 
symbols, and SETC symbols. The three types 
of variable symbols differ in how they are 
assigned values. 



Assigning Values to Variable Symtx^ls 



THE ASSEMBLER SOURCE STATEMENT LIBRARY 



Symbolic parameters are assigned values by 
the programmer each time he writes a macro- 
instruction. 



The same macro- definition may be made avai- 
lable to more than one source program by 
placing the macro-definition in the assem- 
bler source statement library- This system 
library is a collection of macro- 
definitions that can be used by all the 
assembler language programs in an 
installation. Once a macro- definition has 
been placed in the source statement library 
it may be used by writing a corresponding 
macro-instruction in a source program. 
Macro-definitions must be in the assembler 
source statement library under the same 
name as the prototype. The procedure for 
placing macro-definitions in the source 
statement library is described in the Sys- 
tem Control and System Service Programs 
publication listed in the Preface. 

System macro instructions provided by 
IBM, are described in the Supervisor and 
Input/output Macros publication, also list- 
ed in the Preface. 



System variable symbols are assigned 
values by the assembler each time it proc- 
esses a macro-instruction. 

SET symbols are assigned values by the 
programmer by means of conditional assembly 
instructions. 



Global SET Symbols 



The values assigned to SET symbols in one 
macro-definition may be used in other 
macro- definitions. All SET symbols used 
for this purpose must be defined as global 
SET symbols. All other SET symbols must be 
defined by the programmer as local SET 
symbols. Local SET symbols and the other 
variable symbols (that is, symbolic param- 
eters and system variable symbols) are 
local variable symbols. Global SET symbols 
are global variable symbols. 



VARIABLE SYMBOLS 



ORGANIZATION OF THIS PART OF THE 
PUBLICATION 



A variable symbol is a type of symbol that 
is assigned various values by either the 
programmer or the assembler. Thus, varia- 
ble symbols allow different values to be 
assigned to one symbol. When the assembler 
uses a macro-definition to determine what 
statements are to replace a macro- 
instruction, variable symbols in the model 
statements are replaced with the current 
values assigned to them. 

A variable symbol is written as an 
ampersand followed by from one to seven 
letters and/or digits, the first of which 
must be a letter. 



Sections 7 and 8 describe the basic rules 
for preparing macro-definitions and for 
writing macro- instructions. 

Section 9 describes the rules for writ- 
ing conditional assembly instructions. 

Section 10 describes additional features 
including rules for defining global SET 
symbols, preparing keyword and mixed-mode 
macro-definitions, and writing keyword and 
mixed- mode macro- instructions. 

Appendix G contains a reference summary 
of the complete macro facilities. 
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Examples of the use of the features of 
the language appear throughout the remain- 
der of the publication. These examples 
illustrate the use of particular features. 
However, they are not meant to show the 
full versatility of these features. 



60 



SECTION 7: HOW TO PREPARE MACRO-DEFINITIONS 



A macro-definition consists of 



1. 
2. 

3. 



4. 



A macro-definition header statement. 
A macro-instruction prototype state- 
ment. 

Zero or more model statements, COPY 
statements, MEXIT, or MNOtE instruc- 
tions. 
A macro-definition trailer statement. 



r T r T 

I Name | Operation | Operand | 

^ + 1 ^ 

I Not I MEND I Not used, must not | 
I used I I be present | 

L ± X J 



Except for MEXIT, MNOTE, and conditional 
assembly instructions, this section of the 
publication describes the statements that 
may be used to prepare macro- definitions. 
Conditional assembly instructions are des- 
cribed in Section 9 . MEXIT and MNOTE 
instructions are described in Section 10 . 

Macro-definitions in a source program 
must appear before all PUNCH a^d REPRO 
statements which appear in thelmain pro- 
gram. Specifically, only the listing con- 
trol instructions (EJECT, PRINt, SPACE, and 
TITLE), ICTL and ISEQ instructions, and 
comments statements may occur before the 
macro-definitions. All but the ICTL 
instruction may appear between macro- 
definitions if there is more tfian one 
definition in the source program. 



MACRO — MACRO-DEFINITION HEADER 



MACRO- INSTRUCTION PROTOTYPE 



The macro-instruction prototype statement 
(also called the prototype statement) 
specifies the name entry, mnemonic opera- 
tion code, and the form of all macro- 
instructions that refer to the macro- 
definition. It must be the second state- 
ment of every macro- definition. The 
typical form of this statement is: 



I Name 



h 

I A symbolic 
I parameter 
I or not 
jused 

L 



I Operation [Operand 



^ 1 ^ 

I A symbol | Zero to 100 sym- | 
I bolic parameters, I 

I I separated by com- | 

j mas I 

L L J 



The macro-definition header stfitement 
denotes the beginning of a mac^o- 
definition. It must be the first statement 
in every macro-definition. The form of 
this statement is: 



r T T ' T 

I Name | Operation | Operand | 
j. 1 1 ^ 

I Not used, I MACRO 1 Not used, must | 
[must not I I not ^e present | 

I be present | | j 

I X X J 



MEND — MACRO-DEFINITION TRAILER 



The macro-definition trailer statement 
denotes the end of a macro-definition. It 
must be the last statement in every macro- 
definition. The form of this statement is; 



The symbolic parameters are used in the 
macro- definition to represent the name 
entry and operands of the corresponding 
macro- instruct ion. A description of sym- 
bolic parameters appears following Model 
Statements . 

The name entry of the prototype state- 
ment may be unused or it may contain a 
symbolic parameter. 

The symbol in the operation entry is the 
mnemonic operation code that must appear in 
all macro- instructions that refer to this 
macro- definition. The mnemonic operation 
code must not be the same as the mnemonic 
operation code of another macro-definition 
in the source program or of a machine 
instruction or assembler instruction. 

The operand entry may contain zero to 
100 symbolic parameters separated by com- 
mas. 
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The following is a prototype statement. 



JNairte | Operation [Operand 
I + + 

I gNAjyiE I MOVE 
1 J. 



STO,6FROM 






Alternate Statement Form 



The prototype statement may be written in a 
form different from that used for machine 
or assembler instructions. The normal form 
is described in Part 1 of this publication. 
The alternate form described here allows 
the programmer to write an operand on each 
line, and allows the interspersing of oper- 
ands and comments in the statement. 



In the alternate form, as in the normal 
form, the name and operation entries must 
appear on the first line of the statement, 
and at least one blank must follow the 
operation entry on that line. Both types 
of statement forms may be used in the same 
prototype statement. 



The rules for using the alternate state- 
ment form are: 



1. If an operand is followed by a comma 
and a blank, and the column after the 
end column contains a nonblank charac- 
ter, the operand entry may be contin- 
ued on the next line starting in the 
continue column. More than one oper- 
and may appear on the same line. 

2. Comments may appear after the blank 
that indicates the end of an operand, 
up to and including the end column. 

3. If the next line starts after the 
continue column, the information 
entered on that line is considered to 
be comments, and the operand field is 
considered terminated. Any subsequent 
continuation lines are considered to 
contain only comments. 



Note : A prototype statement may be 
written on as many continuation lines as is 
necessary to contain 100 operands and asso- 
ciated comments. 

The following examples illustrate: (1) 
the normal statement form, (2) the alter- 
nate statement form, and (3) the combina- 
tion of both statement forms. 



Name 

I 

NAMEl 

INAME2 



-T 

|Oper- 
I ation 

|0P1 



I Operand Comments j | 

I 1 

I OPERANDI , OPERAND 2 , OPERAN j X | 
D3 THE NORMAL FORM I I 



f- 



..j ^ _ ^..^ 

IOP2 1 OPERANDI, THIS IS THE ALJXJ 

I OPERAND2 , 0PERAND3 , TERNA j X j 

TE STATEMENT 1X| 

FORM I I 



NAME3 I0P3 I OPERANDI, THIS IS A COMB|X| 
I OPERAND2 , OPERAND 3 , OPERAN | X j 
I D4, OPERANDS INATION OF |X| 
.BOTH STATEMENT FORMATS | | 

L L j. , J._J 



MODEL STATEMENTS 



Model statements are the macro-definition 
statements from which the desired sequences 
of machine instructions and certain assem- 
bler instructions are generated. Zero or 
more model statements may follow the proto- 
type statement. A model statement consists 
of one to four entries. They are, from 
left to right, the name, operation, oper- 
and, and com,m.ents entries. 

The name entry may be unused, or it may 
contain an ordinary symbol, a sequence 
symbol or a variable symbol, depending on 
the particular statement. 

The operation entry may contain any 
machine, assembler, or macro instruction 
mnemonic operation code, except COPY, END, 
ICTL, ISEQ, and PRINT; or it may contain a 
variable symbol. Variable symbols may not 
be used to generate the following mnemonic 
operation codes, nor may variable symbols 
be used in the name and operand entries of 
these instructions: COPY, END, ICTL, or 
ISEQ. Variable symbols may not be used to 
generate CSECT, DSECT, PRINT, REPRO, START, 
MACRO, MEND, MEXIT, LCLA, LCLB, LCLC, GBLA, 
GBLB, GBLC, SETA, SETB, SETC, AIF, AGO, 
ANOP, or macro- instruction mnemonic opera- 
tion codes. Variable symbols may not be 
used to generate the name and operation 
code of the ACTR instruction- 
Variable symbols may also be used out- 
side of macro-definitions to generate mne- 
monic operation codes with the preceding 
restrictions. 

Although COPY statements may not be used 
as model statements, they may be part of a 
macro-definition. The use of COPY state- 
ments is described under COPY Statements . 

The operand entry may contain ordinary 
symbols or variable symbols. Sequence 
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symbols must appear in the operand entry of 
AGO and AIF instructions. 

The conunents entry may contain any com- 
bination of characters. Substitution by 
the use of variable symbols is not allowed. 

If a REPRO statement is used as a model 
statement, it must be explicitly written in 
the operation entry. It may not he. gener- 
ated as a result of replacing a variable 
symbol by its value. Also, the line fol- 
lowing it may not contain variable symbols. 



Header | 
Prototype I &NAME 
Model I &NAME 
Model I 
Model I 
Model I 
Trailer | 

L 



j Name [operation j Operand 

I I MACRO I 

I MOVE [6 TO, 6 FROM 

I ST I 2 , SAVE 

IL |2,£FR0M 

1ST 12,&TO 

I L 12, SAVE 

I MEND I 



-H 



SYMBOLIC PARAMETERS 



A symbolic parameter is a type of variable 
symbol consisting of an ampersand followed 
by one to seven letters and/or numbers, the 
first of which must be a letter. Symbolic 
parameters appear in prototype and model 
statements. They are assigned values by 
the programmer when he writes a macro- 
instruction. The programmer may Vciry 
statements that are generated for each 
occurrence of a macro-instruction by vary- 
ing the values assigned to symbolic param- 
eters. 

Any symbolic parameters in a model 
statement must appear in the prototype 
statement of the macro-definition. 



Symbolic parameters in model statements 
are replaced by the characters of the 
macro-instruction operand that correspond 
to the symbolic parameters. 



In the following example the characters 
HERE, FIELD A, and FIELDB of the MOVE macro- 
instruction correspond to the symbolic 
parameters &NAME, 6T0, and 6FR0M, 
respectively, of the MOVE prototype state- 
ment. 



r r r t 

|Name |Operation JOperand | 

^ ^ 1 ^ 

|HEEIE I MOVE | FIELDA, FIELDB | 

L X L J 



The progranuner should not use &SYS as 
the first four characters of a symbolic 
parameter. 

The following are valid symbolic param- 
eters : 



SREADER 


6 LOOP 2 


6A23U56 


6N 


6X4F2 


&SU 



The following are invalid symbolic pa- 
rameters: 



Any occurrence of the symtKilic parame- 
ters SNAME, 6T0, and 6 FROM in a model 
statement will be replaced by the charac- 
ters HERE, FIELDA, and FIELDB, respective- 
ly. If the preceding macro-instruction was 
used in a source prograni, the following 
assembler language statements would be 
generated: 



CARDAREA (first character is not an 
ampersand) 

S256B (first character after 
ampersand is not a 
letter) 

&AREA2456 (more than seven characters 
aftei: the ampersand) 

£BCD(34) (contains a special charac- 
ter other than initial 
ampersand) 

6IN AREA (contains a special charac- 
ter, i.e., blank, other 
than initial ampersand) 

The following is an example of a macro- 
definition. Note that the symbolic 
parameters in the model statements appear 
in the prototype statement. 



J. ,., ^ ^ 

I Name | Operation [Operand | 

j. 1 + ^ 

I HERE I ST I 2 , SAVE 1 

j |L 12, FIELDB | 

I I ST 12, FIELDA | 

I \L I 2, SAVE I 

t 1 J J 



The example below illustrates another 
use of the MOVE macro-instruction using 
different operands than those that appear 
in the preceding example. 
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r T T ! 

I Name [Operation | Operand | 

^ +. 1 ^ 

Macro I LABEL | MOVE j IN, OUT j 
j 1 1 ^ 

Generated j LABEL | ST | 2, SAVE | 

Generated! JL 12, OUT j 

Generated! I ST |2,IN | 

Generated! !L ! 2, SAVE | 

L X J .^ J 



If a symbolic parameter appears in the 
comments field of a model statement, it is 
not replaced by the corresponding charac- 
ters of the macro- instruction. 



Concatenating Symbolic Parameters with 
Other Characters or Other Symbolic 
Parameters 



Concatenation is the process of linking or 
joining together in a sequence, with a 
specified order. To concatenate is to join 
together in a specified order. 

If a symbolic parameter in a model 
statement is immediately preceded or fol- 
lowed by other characters or another sym- 
bolic parameter, the characters that cor- 
respond to the symbolic parameter are com- 
bined, in the order given, in the generated 
statement, with the other characters or the 
characters that correspond to the other 
symbolic parameter. This process is called 
concatenation. 

The macro-definition, macro- instruction, 
and generated statements in the following 
example illustrate these rules. 



I Name | Oper at ion j Operand 



Header 

Prototype 

Model 

Model 

Model 

Model 

Trailer 

Macro 

Generated 
Generated 
Generated 
Generated 



1-- 



6 NAME 
6 NAME 



HERE 
HERE 



MACRO 

MOVE 

ST6TY 

L6TY 

ST6TY 

L6TY 

MEND 



I 

!6TY,SP,6TO,6FROM 

I 2,SAVEAREA 

!2,6P6FROM 

|2,6P6TO 

|2,SAVEAREA 

I 



MOVE 



D, FIELD, A, B 



STD 
LD 
STD 
LD 



2,SAVEAREA 
2, FIELDS 
2 , FIELDA 
2 , SAVEAREA 



generated statements. The character D in 
the macro- instruction corresponds to sym- 
bolic parameter 6TY. Since &TY is preceded 
by other characters (i.e., ST and L) in the 
model statements, the character that cor- 
responds to 6TY (i.e., D) is concatenated 
with the other characters to form the oper- 
ation fields of the generated statements. 



The symbolic parameters SP, 6T0, and 
SFROM are used in two of the model state- 
ments to vary part of the operand fields of 
the corresponding generated statements. 
The characters FIELD, A, and B correspond 
to the symbolic parameters 6P, 6TO, and 
SFROM, respectively. Since SP is followed 
by SFROM in the second model statement, the 
characters that correspond to them (i.e., 
FIELD and B) are concatenated to form part 
of the operand field of the second generat- 
ed statement. Similarly, FIELD and A are 
concatenated to form part of the operand 
field of the third generated statement. 



If the programmer wishes to concatenate 
a symbolic parameter with a letter, digit, 
left parenthesis, or period following the 
symbolic parameter he must immediately 
follow the symbolic parameter with a per- 
iod. A period is optional if the symbolic 
parameter is to be concatenated with anoth- 
er symbolic parameter, or a special charac- 
ter other than a left parenthesis or anoth- 
er period that follows it. 

If a symbolic parameter is immediately 
followed by a period, then the symbolic 
parameter and the period are replaced by 
the characters that correspond to the sym- 
bolic parameter. A period that immediately 
follows a symbolic parameter does not 
appear in the generated statement. 

The following macro- definition, macro- 
instruction, and generated statements 
illustrate these rules. 



r T T 

I Name j Operation | Operand 



The symbolic parameter STY is used in 
each of the four model statements to vary 
the mnemonic operation code of each of the 



Header 

Prototype 

Model 

Model 

Model 

Model 

Trailer 


! 1 MACRO 
!S NAME! MOVE 
JSNAMEIST 
1 |L 

! !ST 

1 |L 

! 1 MEND 

1- + 

! HERE 1 MOVE 

IHERE |ST 

1 IL 
1 iST 

1 |L 

1. _ _,i.._ 


1 1 
JSP,6S,6R1,SR2 ! 
|SR1,SS. (6R2) 1 
|6R1,SP.B ! 
|SR1,6P.A 1 
1SR1,SS. (6R2) j 
1 i 

! FIELD, SAVE, 2, 4 1 

!2,SAVE(4) 1 
!2,FIELDB 1 
12, FIELDA 1 
1 2, SAVE (4) 1 

L J 


Macro 


Generated 
Generated 
Generated 
Generated 
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The symbolic parameter &P is used in the 
second and third model statemeiiits to vary 
part of the operand field of each of the 
corresponding generated statements. The 
characters FIELD of the macro- instruction 
correspond to 6P. Since SP is to be conca- 
tenated with a letter (i.e., B and A) in 
each of the statements, a period immediate- 
ly follows 6P in each of the model state- 
ments. The period does not appear in the 
generated statements. 

Similarly, symbolic parameter 63 is used 
in the first and fourth model Statements to 
vary the operand fields of the correspond- 
ing generated statements. 6S is followed 
by a period in each of the model state- 
ments, because it is to be concatenated 
with a left parenthesis. The period does 
not appear in the generated statements. 



The use of variable symbols for substi- 
tution in comments statements is not 
allowed. The ♦ or .♦ of a comment state- 
ment, therefore, cannot be created by sub- 
stitution for a variable symbol. 



COPY STATEMENTS 



A COPY Statement is not a model statement. 
COPY statements may be used to copy model 
statements and MEXIT, and MNOTE instruc- 
tions into a macro- definition from a system 
library, just as they may be used outside 
macro- definitions to copy source statements 
into an assembler language program. 



Comments Statements 



The form of this statement is: 



A model statement may be a comments state- 
ment. A comments statement consists of an 
asterisk in the begin column, followed by 
comments. The comments statement is used 
by the assembler to generate an assembler 
language comments statement, just as other 
model statements are used by the assembler 
to generate assembler language statements. 

The programmer may also write comments 
statements in a macro-definition which are 
not to be generated. These statements must 
have a period in the begin column, immedi- 
ately followed by an asterisk and the com- 
ments . 

The first statement in the following 
example will be used by the assembler to 
generate a comments statement; the second 
statement will not* 



r 1 

I Name | Operation [Operand | 

Y . 4 

I » THIS STATEMENT WILL BE GENERATED ) 
|.* THIS ONE WILL NOT BE GENERATED j 

L . J 



r T T 1 

I Name | Operation | Operand j 
^ + 1 ^ 

I Not used, j COPY I A symbol j 
I must not I I I 

i be present | | | 

L J X J 



The symbol in the operand entry iden- 
tifies the section of coding to be copied- 
Any statement that may be used in a macro- 
definition may be part of the copied 
coding, except MACRO, MEND, COPY, and pro- 
totype statements. 



Statements COPYed into the program must 
obey the restrictions on ordering of state- 
ments. For example, COPY must be between 
global and local declarations in the macro- 
definition or in the main program if the 
COPYed text contains global and local 
declara tions . 
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SECTION 8: HOW TO WRITE MACR0-INSTRIK:TI0NS 



The typical form of a macro- instruction is: 



JName [Operation ) Operand | 

JA symbol j Mnemonic jzero or more op- j 
I or not I operation |erands, separated j 
I used I code |by commas. | 

L J. ± J 



The name entry of the macro- instruction 
may contain a symbol. The symbol will not 
be defined in the generation process unless 
a symbolic parameter appears in the name 
entry of the prototype and the same param- 
eter appears in the name entry of a model 
statement. 

The operation entry contains the mnemon- 
ic operation code of the macro- instruction. 
The mnemonic operation code must be the 
same as the mnemonic operation code of a 
macro-definition in the source program or 
in the source statement library. 

The macro-definition with the same mne- 
monic operation code is used by the assem- 
bler to process the macro- instruction. If 
a macro-definition in the source program 
and one in the source statement library 
have the same mnemonic operation code, the 
macro-definition in the source program is 
used. 

The placement and order of the operands 
in the macro-instruction may be determined 
by the placement and order of the symbolic 
parameters in the operand entry of the 
prototype statement. 



MACRO- INSTRUCTION OPERANDS 



The first sequence of characters starts 
with the first apostrophe in the operand. 
Subsequent character sequences start with 
the first apostrophe after the apostrophe 
that ends the previous sequence of charac- 
ters. 

In the following example, there are two 
sequences of characters enclosed within 
single apostrophes. Therefore, there are 
two sets of paired apostrophes: the first 
and fourth apostrophes, and the fifth and 
sixth apostrophes. 

'A''B*C'D* 

An apostrophe, immediately followed by a 
letter, and immediately preceded by the 
letter L (when L is preceded by any special 
character other than an ampersand) , is not 
considered in determining paired apostroph- 
es. For instance, in the following exam- 
ple, the middle apostrophe is not consid- 
ered. 

•L' SYMBOL* 
*AL*SYMBOL' is an invalid operand. 

Paired Parentheses: There must be an equal 
number of left and right parentheses. The 
nth left parenthesis must appear to the 
left of the nth right parenthesis. 

Paired parentheses are a left parenthe- 
sis and a following right parenthesis with- 
out any other parentheses intervening. If 
there, is more than one pair, each addition- 
al pair is determined by removing any pairs 
already recognized and reapplying the above 
rule for paired parentheses. For instance, 
in the following example the first and 
fourth, the second and third, and the fifth 
and sixth parentheses are each paired pa- 
rentheses. 

(A{B)C)D(E) 



Any combination of up to 127 characters may 
be used as a macro-instruction operand 
provided that the following rules concern- 
ing apostrophes , parentheses, equal signs, 
ampersands, commas, and blanks are 
observed. 

Paired Apostrophes: An operand may contain 
one or more sequences of characters, each 
of which is enclosed within single apos- 
trophes, (The sequence of characters 
itself may contain an even number of 
apostrophes). The single apostrophes, 
which enclose the sequence of characters, 
are called paired apostrophes. 



A parenthesis that appears between 
paired apostrophes is not considered in 
determining paired parentheses. For 
instance, in the following example the 
middle parenthesis is not considered. 

(')•) 

Equal Signs: An equal sign can only occur 
as the first character in an operand or 
between paired apostrophes or paired pa- 
rentheses. The following examples illus- 
trate these rules, 

=F'32' 
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•C=D' 
E(F=G) 



OMITTED OPERANDS 



Ampersands ; Except as noted under "Inner 
Macro-Instructions," each sequence of con- 
secutive ampersands must be an even number 
of ampersands. The following example 
illustrates this rule. 

&S123&&&& 



Comma s ; A comma indicates the end of an 
operand, unless it is placed between paired 
apostrophes or paired parentheses. The 
following example illustrates this rule. 

(A,B)C' ,• 



If an operand that appears in the prototype 
statement is omitted from the macro- 
instruction, then the comma that would have 
separated it from the next operand must be 
present. If the last operand(s) is omitted 
from a macro-instruction, then the comma (s) 
separating the last operand (s) from the 
next previous operand may be omitted. 

The following example shows a macro- 
instruction preceded by its corresponding 
prototype statement. The macro-instruction 
operands that correspond to the third and 
sixth operands of the prototype statement 
are omitted in this example. 



Blanks: Except as noted under Statement 
Form , a blank indicates the end of the 
operand entry, unless it is placed between 
paired apostrophes - The following example 
illustrates this rule. 



r T T 1 

[Name [Operation | Operand | 

^ + _ 1 ^ 

I I EXAMPLE I 6A,6B,6C,eD,6E,6F | 
I ) EXAMPLE 1 17,* + 4,, AREA, FIELD (6) | 

L ± J. J 



•A B C 

The following are valid macro- 
instruction operands : 



SYMBOL 

123 

X'189A' 

* 

L'NAME 
'TEN = 10' 
•COMMA IS 



A* 2 

(TO (8) ,FROM) 

0(2,3) 

=F«U096' 

AB6 69 

•PARENTHESIS IS ) ' 

•APOSTROPHE IS''^ 



The following are invalid macro- 
instruction operands: 



W'NAME 
5A)B 



(15 B) 



•ONE* IS 



(odd number of apostrophes ) 
(number of left parentheses 

does not equal number of 

right parentheses) 
(blank not placed between 

paired apostrophes ) 
(blank not placed between 

paired apostrophes ) 



If the symbolic parameter that 
corresponds to an omitted operand is used 
in a model statement, a null character 
value (not a blank) replaces the symbolic 
parameter in the generated statement, i.e., 
in effect the symbolic parameter is 
removed. 

For example, the first statement below 
is a model statement that contains the 
symbolic parameter 6C. If the operand that 
corresponds to 6C was omitted from the 
macro- instruction, the second statement 
below would be generated from the model 
statement. 



r r r 1 

IName | Operation [Operand | 

^ + 1 ^ 

I jMVC jTHERESC. 25,THIS | 

I |MVC I THERE 2 5, THIS [ 

L X L J 



OPERAND SUBLISTS 



STATEMENT FORM 



An operand of a macro- instruction may be a 
sublist. 



Macro- instruct ions may be written using 
the same alternate form that can be used to 
write prototype statements. If this foirro 
is used, a blank does not always indicate 
the end of the operand entry., The 
alternate form is described in Section 7, 
under the subsection "Macro- Instruction 
Prototype. " 



Sublists provide the programmer with a 
convenient way to refer to: (1) a collec- 
tion of macro-instruction operands as a 
single operand, or (2) a single operand in 
a collection of operands. 

A sublist consists of one or more oper- 
ands (suboperands) separated by commas and 
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enclosed in paired parentheses. The entire 
sublist, including the parentheses, is 
considered to be one macro- instruction 
operand. 

Omitted suboperands are handled in the 
same way as omitted operands. If () 
appears as an operand, however, it is 
treated as a character string, not as a 
sublist with all suboperands omitted. 

If a macro-instruction is written in the 
alternate statement format, each sublist 
operand may be written on a separate line; 
the macro-instruction may be written on as 
many lines as there are operands, including 
sublist operands. 

The limit of 100 operands applies to the 
total of suboperands and non-sublisted 
operands. The limit of 127 characters per 
operand applies to an entire sublist 
including parentheses and commas. 

If 6P1 is a symbolic parameter in a 
prototype statement, and the corresponding 
operand of a macro-instruction is a sub- 
list, then fiPKn) may be used in a model 
statement to refer to the nth operand of 
the sublist, where n may be a decimal self- 
defining term. {n may also be any 
arithmetic expression allowed in a SETA 
instruction. The SETA instruction is des- 
cribed in Section 9 . ) n must be in the 
range of 1 through 100. If &P1 is a sym- 
bolic parameter, and the corresponding 
operand of a macro-instruction is a sub- 
list, then &P1 refers to the entire sublist 
( including parentheses ) . 

For example, consider the following 
macro-definition, macro-instruction, and 
generated statements. 



Name 



i- 



"T T 

I Operation | Operand 



Header 


1 MACRO 


1 1 


Prototype 


1 ADDNUM 


|6NUM,6REG,6AREA| 


Model 


|L 


|6REG,6NUM(1) | 


Model 


|A 


|6REG, &NUM(2) | 


Model 


|A 


|&REG,6NUM(3) | 


Model 


1ST 


1 6REG , SAREA | 


Trailer 


IMEND 
1 ADDNUM 


1 1 
1 (A,B,C) ,6,S0M 1 


Macro 


Generated 


|L 


|6,A 1 


Generated 


|A 


|6,B 1 


Generated 


|A 


16, C j 


Generated 


1ST 


|6,SUM 1 
— X 1 



of three of the model statements. For 
excimple, €NUM(1) refers to the first oper- 
and in the sublist corresponding to symbol- 
ic parameter SNOM. The first operand of 
the sublist is A. Therefore, A replaces 
£NUM(1) to form part of the generated 
statement. 

Note: When referring to an operand in a 
sublist, the left parenthesis of the sub- 
list notation must iiranediately follow the 
last character of the symbolic parameter, 
e.g., SNUMCl). A period should not be 
placed between the left parenthesis and the 
last character of the symbolic parameter. 

A period may be used between these two 
characters only when the programmer wants 
to concatenate the left parenthesis with 
the characters that the symbolic parameter 
represents. The following example shows 
what would be generated if a period 
appeared between the left parenthesis and 
the last character of the symbolic parame- 
ter in the first model statement of the 
above example. 



The operand of the macro-instruction 
that corresponds to symbolic parameter &NUM 
is a sublist. One of the operands in the 
sublist is referred to in the operand entry 



r r r 1 

I Name I Operation I Operand ) 

Prototype} | ADDNUM | 6NUM, 6REG, 6AREA | 

Model I |L |&REG,&NUM. (1) j 

Macro I jADDNDM | (A,B,C) , 6 ,SUM \ 

Generated! |L 1 6, (A,B,C) (1) | 

i L L . J 



The symbolic parameter 6NUM is used in 
the operand entry of the model statement. 
The characters (A,B,C) of the macro- 
instruction correspond to €NUM. Since 6NUM 
is immediately followed by a period, 6NUM 
and the period are replaced by (A,B,C). 
The period does not appear in the generated 
statement. The resulting generated 
statement is an invalid assembler language 
statement. 



INNER MACRO- INSTRUCTIONS 



A macro-instruction may be used as a model 
statement in a macro-definition. Macro- 
instructions used as model statements are 
called inner macro-instructions. 

A macro-instruction that is not used as 
a model statement is referred to as an 
outer macro- instruction. 

Any symbolic parameters used in an inner 
macro- instruction are replaced by the 
corresponding operands of the outer macro- 
instruction. 



68 



The macro-definition correspbnding to an 
inner macro-instruction is used! to generate 
the statements that replace the inner 
macro- instruction. 

The ADDNUM macro-instruction of the 
previous example is used as an inner macro- 
instruction in the following example. 

The inner macro- instruction contains two 
symbolic parameters, 6S and 6T. The 
characters {X,Y,Z) and J of the macro- 
instruction correspond to feS and fcT, 
respectively. Therefore, these; characters 
replace the symbolic parameters; in the 
operand entry of the inner macro- 
instruction. 

The assembler then uses the Imacro- 
definition that corresponds to the inner 
macro-instruction to generate sitatements to 
replace the inner macro-instruction. The 
fourth through seventh generated statements 
have been generated for the innler macro- 
instruction. 



Header 

Prototype] 

Model 

Model 

Model 

Inner 

Model 
Trailer 



r T T — 

I Name | Operation | Operand 
^ + + ^_.. 



Outer 

Generated] 
Generated] 
Generated] 

Generated) 
Generated] 
Generated! 
Generated] 

Generated 



^- 





1 MACRO 


1 




jCOMP 


|6R1,6R2,SS,6T,6U 




|SR 


|6R1,6R2 




|c 


1 SRI , &T 




|BNE 


l&u 




1 ADDNUM 


I6S,12,6T| 
_ i— — _J 


6U 


|A 

1 MEND 

1 MACRO 


|6R1,6T 

1 
1 




1 ADDNUM 


ISNUM, 6REG,6AREA 




|L 


|6REG,&NUM(1) 




|A 


|6REG,£iNUM(2) 




]A 


1 SREG,6JNUM(3) 




1ST 


1 6REG,6iAREA 




|MEND 
1 


1 
_ i. 


K 


|COMP 


110,11, (X,Y,Z), J, K 





-+ 

|SR 


._! „ 

110,11 




ic 


110, J 




|BNE 


|K 
|12,X 1 




|L 




|A 


|12,Y 1 




|A 


112, Z 1 




1ST 


112, J 1 

X _ J 


K 


_-L 


|10,J 

± 



Note ; An ampersand that is part of a 
symbolic parameter is not considered in 
determining whether a macro- instruct ion 
operand contains an even number of 
consecutive ampersands. 



LEVELS OF MACRO- INSTRUCTIONS 



A macro-definition that corresponds to an 
outer macro- instruction may contain any 
number of inner macro- instructions. The 
outer macro-instruction is called a first 
level macro- instruct ion. Each of the inner 
macro-instructions is called a second level 
macro- instruction. 



The macro-definition that corresponds to 
a second level macro-instruction may con- 
tain any number of inner macro- 
instructions. These macro- instructions are 
called third level macro- instructions, etc. 



The number of levels of macro- 
instructions that may be used depends upon 
the complexity of the macro-definition and 
the amount of storage available. This is 
described in detail in Appendix H. 
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SECTION 9: HOW TO WRITE CONDITIONAL ASSEMBLY INSTRUCTIONS 



The conditional assembly instructions allow 
the programmer to: (1) define and assign 
values to SET symbols that can be used to 
vary parts of generated statements, and (2) 
vary the sequence of generated statements. 
Thus, the progrananer can use these 
instructions to generate many different 
sequences of statements from the same 
macro-definition. 

There are 13 conditional assembly 
instructions, 10 of which are described in 
this section. The other three conditional 
assembly instructions — GBLA, GBLB, and 
GBLC — are described in Section 10. The 
instructions described in this section are: 



LCLA SETA AIF 
LCLB SETB AGO 
LCLC SETC ACTR 



ANOP 



The primary use of the conditional 
assembly instructions is in macro- 
definitions. However, all of them (except 
ACTR) may be used anywhere in an assembler 
language source program. 

Where the use of an instruction outside 
macro-definitions differs from its use 
within macro-definitions, the difference is 
described in the subsequent text. 

The LCLA, LCLB, and LCLC instructions 
must be used to define and assign initial 
values to local SET symbols. 

The SETA, SETB, and SETC instructions 
may be used to assign arithmetic, binary, 
and character values, respectively, to SET 
symbols. The SETB instruction is described 
after the SETA and SETC instructions, 
because the operand of the SETB instruction 
is a combination of the operands of the 
SETA and SETC instructions. 



SET SYMBOLS 



SET symbols are one type of variable sym- 
bol. The symbolic parameters discussed in 
Section 7 are another type of variable 
symbol. SET symbols differ from symbolic 
parameters in three ways: (1) where they 
can be used in an assembler language source 
program, (2) how they are assigned values, 
and (3) how the values assigned to them can 
be changed. 

Symbolic parameters can only be used in 
macro-definitions, whereas SET symbols can 
be used inside and outside macro- 
definitions. 

Symbolic parameters are assigned values 
by SETA, SETB, and SETC conditional 
assembly instructions and by local or glo- 
bal declarations. 

Each symbolic parameter is assigned a 
single value for one use of a macro- 
definition, whereas the values assigned to 
each SETA, SETB, and SETC symbol are not so 
restricted. 



Defining SET Symbols 



SET symbols must be defined by the 
programmer before they are used. When a 
SET symbol is defined it is assigned an 
initial value, SET symbols may be assigned 
new values by means of the SETA, SETB, and 
SETC instructions. A SET symbol is defined 
when it appears as an operand of an LCLA, 
LCLB, or LCLC instruction. 



The AIF, AGO, and ANOP instructions may 
be used in conjunction with sequence sym- 
bols to vary the sequence in which state- 
ments are assembled. The programmer can 
test attributes assigned by the assembler 
to macro-instruction operands to determine 
which statements are to be processed. The 
ACTR instruction may be used to limit the 
number of AIF and AGO branches executed in 
any assembly. 

Examples illustrating the use of condi- 
tional assembly instructions are included 
throughout this section. A chart summariz- 
ing the elements that can be used in each 
instruction appears at the end of this 
section. 



Using Variable Symbols 



The SETA, SETB, and SETC instructions may 
be used to change the values assigned to 
SETA, SETB, and SETC symbols, respectively, 
When a SET symbol appears in the name or 
operand entry of a statement, the currcmt 
value of the SET symbol (i.e., the last 
value assigned to it) replaces the SET 
symbol in the statement. when a SETC sym- 
bol appears in the operation entry of a 
statement, the current value of the SETC 
symbol replaces the SET symbol in the 
statement. 
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For example, if 6 A is a syrtitrolic parame- 
ter, and the corresponding characters of 
the macro-instruction are the symbol HERE, 
then HERE replaces each occurrence of 6A in 
the macro-definition. However, if 6A is a 
SET symbol, the value assigned to 6A can be 
changed, and a different value can replace 
various occurrences of SA in the macro- 
definition. 

The same variable symbol may not be used 
as, a symbolic parameter and as a SET symbol 
in the same macro- definition. 

The following illustrates this rule. 



processing the definition. If a SET symbol 
is used in the operand entry of a macro- 
instruction, and the value assigned to the 
SET symbol is in the form of sublist 
notation, the operand is not considered a 
sublist. 



ATTRIBUTES 



The assembler assigns attributes to macro- 
instruction operands and to symbols in the 
program. 



^ ^ ^ . ^ 

I Name | Operation | Operand | 

J. 1 + _ ^ 

|6NAME I MOVE |6TO,6FROM j 

L X L . J 



There are six kinds of attributes, 
are: type, length, scaling, integer, 
count, and number. 



They 



Each attribute has a notation associated 
with it. The notations are: 



If the statement above is a prototype 
statement, then 6NAME, STO, and SFROM may 
not be used as SET symbols in the macro- 
definition. 

The same variable symbol may not be used 
as two different types of SET symbols in 
the same macro-definition. Similarly, the 
same variable symbol may not be used as two 
different types of SET symbols outside 
macro-definitions . 

For example, if 6A is a SETA symbol in a 
macro-definition, it cannot be used as a 
SETC symbol in that definition. Similarly, 
if 6A is a SETA symbol outside macro- 
definitions, it cannot be used as a SETC 
symibol outside macro-definitions. 

The same variable symbol if declared 
local may be used in two or morie macro- 
definitions and outside macro-definitions. 
If such is the case, the variable symbol 
will be considered a different variable 
symbol each time it is used. 

For example, if 6A is a variable symbol 
(either SET symbol or symbolic parameter) 
in one macro-definition, it can be used as 
a variable symbol (either SET symbol or 
symbolic parameter) in another definition. 
Similarly, if &A is a variable symbol (SET 
symbol or symbolic parameter) in a macro- 
definition, it can be used as a SET symbol 
outside macro-definitions. 



Attribute 


Notation 


Type 


T' 


Length 


L' 


Scaling 


S' 


Integer 


!• 


Count 


K' 


Number 


N' 



The programmer may request an attribute 
in the following places: 

1. Outside Macro-definitions 

a. The attributes L' , I', S', and T' 
may be referenced, where 
meaningful, for ordinary symbols 
which appear outside macro- 
definitions as the name entry of an 
assembler source statement 

(including COPYed statements) or in 
the operand of an EXTRN statement. 
(See the following detailed 
description of these attributes.) 

b. Because attributes of other ordi- 
nary symbols (including those 
generated) are not available, only 
the T* attribute may be re<iuested, 
and its value is U (Undefined). 

c. Attributes of variable symbols 
cannot be referenced outside macro- 
definitions, definitions. 

2, Within Outer Macro-definitions 



All variable symbols may be concatenated 
with other characters in the same way as 
symbolic parameters. The rules for 
concatenation are in Section 7 under the 
subsection Model Statement s. 

Variable symbols in macro- instruct ions 
are replaced by the values assigned to 
them, immediately prior to the start of 



Only indirect references (using 
symbolic parameters) are permitted 
for the L', I*, S', T', K', and N' 
attributes of ordinary symbols in 
outer macro- instructions. These 
ordinary symbols must appear 
outside macro- definitions as the 
name entry of an assembler source 
statement (including COPYed 
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statements) or in the operand of an 
EXTRN statement. 

b« Because attributes of other ordi- 
nary symbols and SET syrabx)ls out- 
side macro-definitions are not 
available, indirect reference 
(using symbolic parameters) is 
permitted only for T*, K', and N* 
attributes. The value of the T* 
attribute is always U (Undefined) . 

c. Attributes of SET variables defined 
inside the macro-definition corres- 
ponding to the outer macro cannot 
be referenced. 

3. Direct reference to the attributes of 
ordinary symbols (using the symbol 
itself) is not permitted in macro- 
definitions. 

4. For inner macro-instructions, if the 
operand is a symbolic parameter of an 
outer macro, the attributes are the 
same as those of the corresponding 
outer macro- instruction (see item 2). 

If a macro- instruct ion operand is a 
sublist, the programmer may refer to the 
attributes of either the sublist or each 
operand in the sublist. The type, length, 
scaling, and integer attributes of a 
sublist are the same as the corresponding 
attributes of the first operand in the 
sublist. 



A A-type address constant, 

implied length, aligned. 
B Binary constant. 
C Character constant. 
D Long floating-point constant, 

implied length, aligned. 
E Short floating-point constant, 

implied length, aligned. 
F Full-word fixed-point constant, 

implied length, aligned. 
G Fixted- point constant, explicit 

length. 
H Half-word fixed-point constant, 

implied length, aligned. 
K Floating-point constant, 

explicit length. 
P Packed decimal constant. 
R A-, S-, V-, or Y-type address 

constant, explicit length. 
S S-type address constant, 

implied length, aligned. 

V V-type address constant, 
implied length, aligned. 

X Hexadecimal constant, 

Y Y-type address constant, 
implied length, aligned. 

Z Zoned decimal constant. 



The following letters are used for sym- 
bols (and outer macro- instruction operands 
that are symbols) that name statements 
other than DC or DS statements, or that 
appear in the operand field of an EXTRN 
statement. 



All the attributes of macro- instruction 
operands may be referred to in conditional 
assembly instructions within macro- 
definitions. However, only the type, 
length, scaling, and integer attributes of 
symbols may be referred to in conditional 
assembly instructions outside macro- 
definitions. Attributes of symbols 
appearing in the name entry of generated 
statements may not be referred to in condi- 
tional assembly instructions inside or 
outside macro definitions. 



Type Attribute (T*) 



The type attribute of a macro- instruction 
operand or a symbol is a letter. 

The programmer may refer to a type 
attribute in the operand of a SETC instruc- 
tion, or in character relations in the 
operands of SETB or AIF instruction, or in 
other instructions where use of the charac- 
ter is valid. 

The following letters are used for sym- 
bols that name DC and DS statements and for 
outer macro- instruction operands that are 
symbols that name DC or DS statements. 



I Machine instruction 

J Control section name 

M Macro-instruction 

T External symbol 

W CCW assembler instruction 

The following letters are used for inner 
and outer macro-instruction operands only. 

N Self-defining term 
O Omitted operand 

The letter U (Undefined) is used for 
inner and outer macro- instruction operands 
that cannot be assigned any of the above 
letters. The type attribute of all liter- 
als appearing as macro- instruction operands 
is U. This also is true for inner macro- 
instruction operands that are ordinary 
symbols or variable symbols. Because the 
attributes are not available at the 
necessary time, this letter is also 
assigned to symbols that name EQU and LTORG 
statements, to any symbols occurring more 
than once in the hame entry of source 
statements, and to all symbols naming DC 
and DS statements with expressions or vari- 
able symbols as modifiers. The type attri- 
bute also is undefined when the modifier 
expression consists solely of self-defining 
terms. 
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The attributes of A, B, C, and D in the 
following examples are undefined: 

A DC 3FL(A-B)*15' 

B DC (A-B)F'15' 

C DC gX'l* 

D DC FL(3-2)'l* 



Length (L* ) , Scaling (S*), and Integer (I') 
Attributes 



Scaling and integer attributes are 
available for symbols and macro-instruction 
operands only if their type attributes are 
H, F, and G (fixed point) ; D, E, and K 
(floating point); or P and Z (decimal). 

The programmer may refer to the length, 
scaling, and integer attributes in the 
operand field of a SETA instruction, or in 
arithmetic relations in the operand fields 
of SETB or AIF instructions. 



The length, scaling, and integer attributes 
of macro-instruction operands and symbols 
are numeric values. 

The length attribute of a symbol (or of 
a macro-instruction operand that is a 
symbol) is as described in Part I of this 
publication. Reference to the length 
attribute of a variable symbol is illegal 
except for symbolic parameters in SETA, 
SETB, and AIF statements. If the basic L* 
attribute is desired, it can be obtained as 
follows: 

£A SETC * Z* 
€B SETC • L» • • 

MVC 6A(6B£A),X 
After generation, this would result in 

MVC Z(L'Z),X 

Reference must not be made to the length 
attributes of symbols or macro-instruction 
operands whose type attributes are the 
letters M, N, O, T, or U. 

Scaling and integer attributes are pro- 
vided for symbols that name fixed-point, 
floating-point, and decimal DC or DS state- 
ments. 



Count Attribute (KM 



The programmer may refer to the count 
attribute of macro- instruction operands 
only. 

The count attribute is a value equal to 
the number of characters in the macro- 
instruction operand after substituting for 
variable symbols, excluding commas. If the 
operand is a subiist, the count attribute 
includes the beginning and ending 
parentheses and the commas within the sub- 
list. The count attribute of an omitted 
operand is zero. 

If a macro- instruct ion operand contains 
variable symbols, the characters that 
replace the variable symbols, rather than 
the variable symbols, are used to determine 
the count attribute. 

The programmer may refer to the count 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF instruc- 
tions that are part of a macro-definition. 



Fixed Point: The scaling attribute of a 
fixed-point number is the number of bits 
occupied by the fractional portion of the 
fixed-point number. The integer attribute 
of a fixed-point number is the number of 
bits occupied by the integral portion of 
the fixed-point number. 

Floating Point; The scaling attribute of a 
floating-point number is the number of 
hexadecimal zeros in the leftmost portion 
of the fraction. The integer attribute of 
a floating-point number is thcj number of 
significant hexadecimal digits in the frac- 
tion. 

Decimal; The scaling attribute of a deci- 
mal number is the number of decimal digits 
to the right of the decimal point. The 
integer attribute of a decimal number is 
the number of decimal digits to the left of 
the decimal point. 



Number Attribute (N* ) 



The programmer may refer to the number 
attribute of macro-instruction operands 
only. 

The number attribute is a value equal to 
the number of operands in an operand sub- 
list. The number of operands in an operand 
subiist is equal to one plus the number of 
commas that indicate the end of an operand 
in the subiist. 

The following examples illustrates this 
rule. 



(A,B,C,D,E) 

(A,,C,D,E) 

(A,B,C,D) 

(,B,C,D,E) 

(A,B,C,D,) 

(A,B,C,D, , ) 



operands 
operands 
operands 
operands 
operands 
operands 
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If the macro-instruction operand is not 
a sublist, the number attribute is one. If 
the macro-instruction operand is omitted, 
the nximber attribute is zero. 

The programmer may refer to the number 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF instruc- 
tions that are part of a macro-definition. 



Assigning Integer Attributes to Symbols 



The integer attribute is computed from the 
length and scaling attributes. 

Fixed Point; The integer attribute of a 
fixed-point number is equal to eight times 
the length attribute of the number minus 
the scaling attribute minus one; i.e., 
I«=8*L'-S'-1. 

Each of the following statements defines 
a fixed-point field. The length attribute 
of HALFCON is 2, the scaling attribute is 
6, and the integer attribute is 9, The 
length attribute of ONECON is 4, the scal- 
ing attribute is 8, and the integer attri- 
bute is 23. 



P ^ -P ^ 

I Name | Operation | Operand | 

J. ^ 1_^ ^ 

I HALFCON I DC |HS6'-25.9 3' j 

I ONECON I DC |FS8'100.3E-2' | 

L J. X J 



Floating Point; The integer attribute ot a 
floating-point number is equal to two times 
the difference between the length attribute 
of the number and one, minus the scaling 
attribute; i.e., I*=2* (L* -1) -S' . 

Each of the following statements defines 
a floating-point value. The length attri- 
bute of SHORT is U, the scaling attribute 
is 2, and the integer attribute is 4. The 
length attribute of LONG is 8, the scaling 
attribute is 5, and the integer attribute 
is 9. 



scaling attribute minus one; i.e., 
I'=2*L'-S'-1. The integer attribute of a 
zoned decimal number is equal to the dif- 
ference between the length attribute and 
the scaling attribute; i.e., I*=L'-S*. 

Each of the following statements defines 
a decimal field. The length attribute of 
FIRST is 2, the scaling attribute is 2, and 
the integer attribute is 1. The length 
attribute of SECOND is 3, the scaling 
attribute is 0, and the integer attribute 
is 3. The length attribute of THIRD is 4, 
the scaling attribute is 2, and the integer 
attribute is 2. The length attribute of 
FOURTH is 3, the scaling attribute is 2, 
and the integer attribute is 3. 



-^ 



~ 


-T 




-^ . 


" ■" ■" —' 


Name 


|Ope 


ration 


1 Operand 






-1 




_| 





FIRST 


|DC 




|P'+1.25' 




SECOND 


|DC 




|Z'-5U3' 




THIRD 


|DC 




|Z'79.68' 




FOURTH 


|DC 

_J 




|P'79.68' 

_x 





SEQUENCE SYMBOLS 



The name entry of a statement may contain a 
sequence symbol. Sequence symbols provide 
the programmer with the ability to vary the 
sequence in which statements are processed 
by the assembler. 

A sequence symbol is used in the operand 
entry of an AIF or AGO statement to refer 
to the statement named by the sequence 
symbol. 

A sequence symbol may be used in the 
name entry of any statement that does not 
contain a symbol or SET symbol, except a 
prototype statement, or a MACRO, LCLA, 
LCLB, LCLC, GBLA, GBLB, GBLC, ACTR, ICTL, 
ISEQ, COPY, or END instruction. 

A sequence symbol consists of a period 
followed by one through seven letters 
and/or digits, the first of which must be a 
letter. 



i Name j Operation j Operand j 

^ ^ + 4 

[SHORT I DC |ES2''46.415' J 

I LONG I DC |DS5'-3,729' j 

I. ± X J 



Decimal; The integer attribute of a packed 
decimal number is equal to two times the 
length attribute of the number minus the 



The following are valid sequence sym- 
bols : 

.READER .A23a56 
.LOOP2 .X4F2 

.N .sa 

The following are invalid sequence sym- 
bols: 

CARDAREA ( first character is not 
a period) 
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.246B (first character after 

period is not a letter) 

.AREA2ti56 (more than seven characters 
after period) 

.BCD%8U (contains a special character 
other than initial period) 

.IN AREA (contains a special 

character, i.e., blank, 
other than initial period) 

If a sequence symbol appears in the name 
entry of a macro- instruct ion, and the cor- 
responding prototype statement contains a 
symbolic parameter in the name entry, the 
sequence symbol does not replace the sym- 
bolic parameter wherever it is used in the 
macro-definition. 

The following example illustrates this 
rule. 





1 Name 

L _ _ 


-T 

1 Operation 
_i 


j Operand 

X _ _ —^ — 


1 
_j 




r 


t — — 
1 MACRO 


t — — 
1 




1 


1 6NAME 


|MOVE 


|6TO,6FROM 




2 


1 6NAME 


1ST 
|L 

1ST 
|L 

1 MEND 


)2,SAVEAREA 
1 2, 6 FROM 
|2, 6TO 
|2,SAV£AREA 
1 






L ^ 


J _ 




J 


3 


r ~ 

1 .SYM 


1 MOVE 


IFIELDA, FIELDS 


~ 1 




1 


1 _ 


X _ *._ _ _ 


_ _j 


4 




|ST 

|L 

1ST 


1 2,SAVEAREA 
|2,FIELDB 
|2,FIELDA 
|2,SAVEAREA 


1 




L 


_x 


_x 


J 



The LCLA, LCLB, and LCLC instructions 
are used to define and assign initial 
values to SETA, SETB, and SETC symbols, 
respectively. The SETA, SETB, and SETC 
symbols are assigned the initial values of 
0, 0, and null character value, respective- 
ly. 

The programmer should not define any SET 
symbol whose first four characters are 
6SYS. 

All LCLA, LCLB, or LCLC instructions in 
a macro- definition must appear immediately 
after the prototype statement and all GBLA, 
GBLB or GBLC instructions, or another LCLA, 
LCLB, or LCLC instruction. All LCLA, LCLB, 
or LCLC instructions outside macro- 
definitions must appear after all macro- 
definitions in the source program, after 
all GBLA, GBLB, and GBLC instructions 
outside macro-Jef initions, before all con- 
ditional assembly instructions, and PUNCH 
and REPRO statements outside macro- 
definitions, and before the first control 
section of the program. 



SETA — SET ARITHMETIC 



The SETA instruction may be used to assign 
an arithmetic value to a SETA symbol. The 
form of this instruction is: 

r r r 1 

I Name |Operation | Operand | 

^ 1 1 ^ 

I A SETA I SETA |A SETA arithmetic | 
jsymbol ] | expression | 

L X L J 



The symbolic parameter 6NAME is used in 
the name entry of the prototype statement 
(statement 1) and the first model statement 
(statement 2). In the macro-instruction 
(statement 3) a sequence symbol (,SYM) 
corresponds to the symbolic parameter 
6NAME. SNAME is not replaced by .SYM, and, 
therefore, the generated statement 
(statement U) does not contain a name 
entry. 



LCLA, LCLB, LCLC — DEFINE SET SYMBOLS 



The typical form of these instructions is: 

r T T ■ 1 

I Name | Operation! Operand | 

)Not used, I LCLA, I One or more variable 

jmust not I LCLB, or j symbols, that are 
I be 1 LCLC I to be used as SET 
j present j | symbols, separated 

I I I by commas 

L X . J . . 



The expression in the operand entry is 
evaluated as a signed 3 2- bit arithmetic 
value which is assigned to the SETA sym.boi 
in the name entry. The minimum and maximum 
allowable values of the expression are -2^^ 
and +2^^-l, respectively. 

The expression may consist of one term 
or an arithmetic combination of terms. Tht? 
terms that may be used alone or in 
combination with each other are seif- 
defining terms, variable symbols, and the 
length, scaling, integer, count, and number 
attributes. Self-defining terms are 
described in Part 1 of this publication. 

No embedded blanks may appear in a SETA 
arithmetic expression. If the expression 
is enclosed in parentheses, blanks are not 
permitted within the parentheses. 

Note: A SETC variable symbol may appear 
in a SETA expression only if the value of 
the SETC variable is one to eight decimal 
digits. The decimal digits will be con- 
verted to a positive arithmetic value. 
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Note: A SETB symbol may appear in the 
operand of a SETA statement. The binary 
values of 1 (true) and (false) are con- 
verted to the arithmetic values 1 and 0, 
respectively. 

The arithmetic operators that may be 
used to combine the terms of an expression 
are + (addition) , - (subtraction) , 
♦ (multiplication), and / (division). 

An expression may not contain two terms 
or two operators in succession, nor may it 
begin with an operator. 

The following are valid operand fields 
of SETA instructions: 



6AREA+Xr2D« 

&BETA*10 

L'6HERE+32 



I*6N/25 

6EXIT-S*6ENTRY+1 

29 



The following are invalid operand fields 
of SETA instructions: 



6AREAX'C' (two terms in succession) 
SFIELD+- (two operators in succession) 
-6DELTA*2 (begins with an operator) 
♦+32 (begins with an operator; 

two operators in succession) 
NAME/15 (NAME is not a valid term) 



bined terms that are enclosed in parenthe- 
ses. A sequence of parenthesized terms may 
appear within another parenthesized 
sequence. 



The following are examples of SETA 
instmiction operands that contain parenthe- 
sized sequences of terms. 



(L'&HERE+32)*29 

6AREA+X ' 2D • / ( &EXIT-S' 6ENTRY+1) 

6BETA*10*(I'£N/25/(6EXIT-S*6ENTRY+l)) 



The parenthesized portion or portions of 
an arithmetic expression are evaluated 
before the rest of the terms in the expres- 
sion are evaluated. If a sequence of 
parenthesized terms appears within another 
parenthesized sequence, the innermost 
sequence is evaluated first. 



The SETA arithmetic expression can only 
have three levels of parentheses. The 
parentheses required in subscripting, 
substring, and sublist notation count when 
determining these levels. A counter is 
maintained for each SETA statement and 
increased by one for each occurrence of a 
variable symbol as well as the operation 
entry. The maximum value this counter may 
attain is 35. (See Appendix H) . 



EVALUATION OF ARITHMETIC EXPRESSIONS 



The procedure used to evaluate the arith- 
metic expression in the operand of a SETA 
instruction is the same as that used to 
evaluate arithmetic expressions in assem- 
bler language statements. The only 
difference between the two types of arith- 
metic expressions is the terms that are 
allowed in each expression. 

The following evaluation procedure is 
used: 



1. Each term is given its numerical 
value. 

2. The arithmetic operations are per- 
formed moving from left to right. 
However, multiplication and/or divi- 
sion are performed before addition and 
subtraction. 

3. The computed result is the value 
assigned to the SETA symbol in the 
name entry. 

The arithmetic expression in the operand 
entry of a SETA instruction may contain one 
or more sequences of arithmetically com- 



Usinq SETA Symbols 



The arithmetic value assigned to a SETA 
symbol is substituted for the SETA symbol 
when it is used in the operand of a SETA 
instruction, or in arithmetic relations in 
the operand of SETB and AIF instructions. 
If the SETA symbol is used in any other 
statement, the arithmetic value is com- 
pletely converted to an unsigned integer, 
with leading zeros removed. If the value 
is zero, it is converted to a single zero. 



The following example illustrates this 
rule: 
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I Name 

I- 



Operation 



j Operand 
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1 MACRO 
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1 6NAME 
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|6TO,6FROM 
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|LCLA 


|&A,6B,gG,6D 


1 &A 


ISETA 
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1 &B 


ISETA 
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jSNAME 
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1 2,SAVEAREA 


1 


|L 


1 2 , SFROM&C 


1 


1ST 


1 2,6T06D 


1 


|L 


1 2 , SAVEAREA 


1 


IMEND 


I 




-+ 


+ „ „ 


IHERE 

L .. , „ 


IMOVE 
1 


IFIELDA, FIELDS 


r 


T ~ 


1 - — - 


IHERE 


1ST 


1 2, SAVEAREA 


1 


|L 


1 2, FIELDS 2 


1 


1ST 


|2,FIELDA8 


1 


|L 


1 2, SAVEAREA 



t X J. J 



statement 1 assigns the arithmetic value 
+5 to SETA symbol &A. In statement 2, 6A 
is converted to the unsigned integer 5. 
statement 3 assigns the arithmetic value +8 
to 6A. In statement 4 , therefore, 6A is 
converted to the unsigned integer 8, 
instead of 5. 



A SETA symbol may be used with a symbol-* 
ic parameter to refer to an operand in an 
operand sublist- If a SETA symbol is used 
for this purpose it must have been assigned 
a value in the range 1 to 100. 



Any expression that may be used in the 
operand of a SETA instruction may be used 
to refer to an operand in an operand sub- 
list. 



Subiists are descril)ed in Section 8 
under Operand Subiists. 



Statements 1 and 2 assign to the SETA 
symbols SA and 6B the arithmetic values +10 
and +12, respectively. Therefore, state- 
ment 3 assigns the SETA symbol 6C the 
arithmetic value -2. When £C is used in 
statemen*- 5, the arithmetic value -2 is 
converted to the unsigned integer 2„ When 
6C is used in statement 4, however, the 
arithmetic value -2 is used. Therefore, 6D 
is assigned the arithmetic value +8« When 
6D is used in statement 6, the arithmetic 
value +8 is converted to the unsigned inte- 
ger 8. 

The following example shows how the 
value assigned to a SETA symbol may be 
changed in a macro-definition. 



■ ' T T 

Nam.e {Operation | Operand 
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1 6NAME 


IMOVE 


1 6T06FROM 
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1 MOVE 
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1ST 


|FIELDA,FIELDB 
1 2, SAVEAREA 


— ^ 
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|L 


1 2, FIELDB5 
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1ST 


|2,FIELDA8 




1 


|L 


1 2, SAVEAREA 





The following macro-definition may be 
used to add the last operand in an operand 
sublist to the first o[>erand in an operand 
sublist and store the result at the first 
operand. A sample macro-instruction and 
generated statements follow the macro- 
definition. 



r T T 

I Name {Operation | Operand 
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-+ 

{MACRO 


^ 

1 




1 ADDX 


( g NUMBER, & REG 




|LCLA 


{ 6LAST 


1 6 LAST 


{SETA 


(N'SNUMBER 




|L 


1 &REG,6NUMB£R(1) 




|A 


1 SREG , gNUMBER ( gLAST) 




(ST 


1 gREG,&NUMBER{l) 


i— _ 


(MEND 
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1 

_ X — — — — — 


r 

1 _. . 


-f ~ 
lADDX 


T 

{ (A,B,C,D,E) ,3 
_ 1 _ _ ^ 
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|L 


(3, A 




(A 


|3,E 




(ST 


|3,A 



-^ 



L X L 






L X J 



6NUMBER is the first symbolic parameter 
in the operand entry of the prototype 
statement (statement 1). The corresponding 
characters, (A, B,C,r|,E) , of the macro- 
instruction (statement 4) are a sublist. 
Statement 2 assigns to gLAST the arithmetic 
value +5, which is equal to the nurober of 
operands in the sublist, Hierefore, in 
statement 3, £NUMBER(£LAST) is replaced by 
the fifth operand of the sublist. 
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SETC — SET CHARACTER 



The SETC instruction is used to assign a 
character value to a SETC symbol. The form 
of this instruction is: 



r r ~^ ' 1 

I Name | Operation | Operand ) 

I A SETC jSETC | One operand, of | 
j symbol | |the form described | 

I J I below I 

I ± = ± J 



The operand may consist of the type 
attribute, a character expression, a 
substring notation, or a concatenation of 
substring notations and character expres- 
sions. A SETA symbol may appear in the 
operand of a SETC statement. The result is 
the character representation of the decimal 
value, unsigned, with leading zeros 
removed. If the value is zero, one decimal 
zero is used. 

A SETB symbol may appear in the operand 
of a SETC statement; the binary values 1 
(true) and (false) are converted to the 
character values 1 and 0, respectively. 

The maximum size character value that 
can be assigned to a SETC symbol is eight 
characters. If a SETC value longer than 
eight characters is specified as the oper- 
and of a SETC statement, the leftmost eight 
characters are used. 



The character value enclosed in apos- 
trophes in the operand field is assigned to 
the SETC symbol in the name entry. The 
maximum length character value that can be 
assigned to a SETC symbol is eight charac- 
ters. If a value greater than 8 is speci- 
fied, the leftmost 8 characters will be 
used. 



EVALUATION OF CHARACTER EXPRESSIONS; The 
following statement assigns the character 
value AB%4 to the SETC symbol &ALPHA: 

r T r 1 

I Name ) Operation j Operand | 

I6ALPHA ISETC | 'AB%4' \ 



More than one character exj^ression may 
be concatenated into a single character 
expression by placing a period between the 
terminating apostrophe of one character 
expression and the opening apostrophe of 
the next character expression. For exam- 
ple, either of the following statements may 
be used to assign the character value 
ABCDEF to the SETC symbol &BETA. 



r -"T T ^- 1 

I Name | Operation ) Operand | 

I 6 BETA I SETC | ' ABCDEF' | 

JSBETA jSETC |»ABC'.'DEF' | 

L X L J 



TYPE ATTRIBUTE 



The character value assigned to a SETC 
symbol may be a type attribute. If the 
type attribute is used, it must appear 
alone in the operand field. The following 
example assigns to the SETC symbol 6TYPE 
the letter that is the type attribute of 
the macro-instruction operand that corre- 
sponds to the symbolic parameter SABC. 



r T T 1 

I Name | Operation | Operand | 

I6TYPE ISETC |T'6ABC | 

I X X J 



CHARACTER EXPRESSION 



Two apostrophes must be used to rep- 
resent a apostrophe that is part of a char- 
acter expression. 

The following statement assigns the 
character value L* SYMBOL to the SETC symbol 

& LENGTH. 



JName j Operation {Operand j 

I6LENGTH | SETC |'L' 'SYMBOL' | 

L X X J 



Variable symbols may be concatenated 
with other characters in the operand field 
of a SETC instruction according to the 
general rules for concatenating variable 
symbols with other characters (see Section 
7). 



A character expression consists of any 
combination of characters enclosed in apos- 
trophes- The maximum length of a character 
expression is 127 characters. 



If 6ALPHA has been assigned the charac- 
ter value AB%U, the following statement may 
be used to assign the character value 
AB%4RST to the variable symbol 6GAMMA. 



T T 

Name | Operation | Operand 
^ + 

6GAMMA JSETC | ' 6ALPHA.RST* 

X X . 

T T 

Name | Operation | Operand 
1 1 

6DELTA jSETC j ' 6ALPHA' . 'RST' 

J. J. 



Two amper^nds roust be used to represent 
an ampersand that is not part of a variable 
symbol. Both ampersands become part of the 
character value assigned to the SETC sym- 
bol. They are not replaced by a single 
ampersand . 

The following statement assigns the 
character value HALF66 to the SETC symbol 
6 AND. 

r T ~~T 1 

I Name | Operation | Operand | 

j. 1 _ 1 ^ 

I &AND I SETC |'HALF66' j 

L J. X J 

In this example, 

P y — ^ ^ 

IName | Operation | Operand 1 

^ 1 ^ ^ 

I 6A I SETC I • 66BETA' (2,5) | 

L X X , . J 



in parentheses. These parentheses count 
when determining the number of levels of 
parentheses. The two arithmetic expres- 
sions may be any expression that is allowed 
in the operand of a SETA instruction. 

The first expression indicates the first 
character (in the character expression) 
that is to be assigned to the SETC symbol 
in the name entry. The second expression 
indicates the number of consecutive charac- 
ters in the character expression (starting 
with the character indicated by the first 
expression) that are to be assigned to the 
SETC symbol. If a substring specifies more 
characters than are in the character 
string, the number of available characters 
will be supplied. 

The maximum size substring character 
value that can be assigned to a SETC symbol 
is eight characters. The maximum size 
character expression the substring charac- 
ter value can be chosen from is 127 charac- 
ters. 

The following are valid substring nota- 
tions : 



•6ALPHA' (2,5) 

'AB%4' (6AREA+2,1) 

•& ALPHA" . 'RST* (6, 6A) 

• 6ALPHA' . 'RST' (6, 6A) 

• ABC6GAMMA' (6A, 6AREA+2) 



'&6BETA' (2,5) produces 6BETA which is 
considered a character string, not a varia- 
ble symbol. 



The following are invalid substring 
notations: 



SUBSTRING NOTATION 



The character value assigned to a SETC 
symbol may be a substring character value. 
Substring character values permit the pro- 
grammer to assign part of a character value 
to a SETC symbol. 

If the programmer wants to assign part 
of a character value to a SETC symbol, he 
must indicate to the assembler in the oper- 
and of a SETC instruction: (1) the charac- 
ter value itself, and (2) the part of the 
character value he wants to assign to the 
SETC symbol. The concatenation of (1) and 
(2) in the operand of a SETC instruction is 
called a substring notation. The character 
value that is assigned to the SETC symbol 
in the name entry is called a substring 
character value. 

Substring notation consists of a charac- 
ter expression, immediately followed by two 
arithmetic expressions that are separated 
from each other by a comma and are enclosed 



•6BETA' (4,6) 

(blanks between character value 
and arithmetic expressions) 
•L" SYMBOL' (14 2-6XYZ) 

(only one arithmetic expression) 
'ABXISALPHA' (8 &FIELD+2) 

(arithmetic expressions 
not separated by a comma) 
•BETA' 4, 6 

(arithmetic expressions 

not enclosed in parentheses) 
'SALPHA' (2,4) (1,1) 

(double substring notation is not 
permitted) 

CONCATENATING SUBSTRING NOTATIONS AND CHAR- 
ACTER EXPRESSIONS: Substring notations may 
be concatenated with character expressions 
in the operand of a SETC instruction. If a 
substring notation follows a character 
expression, the two may be concatenated by 
placing a period between the terminating 
apostrophe of the character expression and 
the opening apostrophe of the substring 
notation. 

For example, if SALPHA has been assigned 
the character value AB%4, and &BETA has 
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been assigned the character value ABCDEF, 
then the following statement assigns fiGAMMA 
the character value AB%aBCD. 



r 

jName 



"T T 

I Operation ) Operand 



I Name j Operation j operand | 

j 6GAMMA |SETC j ' 6ALPHA' , ' SBETA* (2, 3) | 

L L X J 



If a substring notation precedes a char- 
acter expression or another substring nota- 
tion, the two may be concatenated by writ- 
ing the opening apostrophe of the second 
item immediately after the closing paren- 
thesis of the substring notation. 

The programmer may optionally place a 
period between the closing parenthesis of a 
substring notation and the opening apos- 
trophe of the next item in the operand. 

If 6ALPHA has been assigned the charac- 
ter value AB%4, and 6ABC has been assigned 
the character value 5RS, either of the 
following statements may be used to assign 
6W0RD the character value AB%t45RS. 



r T T 1 

I Name | Operation | Operand | 

^ 1 1 1 

I SWORD |SETC I *6ALPHA' (1,4) '6ABC' j 
I &WORD |SETC I 'gALPHA* (1,4) '6ABC' (1,3) j 
L X X . J 



If a SETC symbol is used in the operand 
of a SETA instruction, the character value 
assigned to the SETC symbol must be one to 
eight decimal digits. 

If a SETA symbol is used in the operand 
of a SETC statement, the arithmetic value 
is converted to an unsigned integer with 
leading zeros removed. If the value is 
zero, it is converted to a single zero. 



Using SETC Symbols 



The character value assigned to a SETC 
symbol is substituted for the SETC symbol 
when it is used in the name or operand of a 
statement. It may also be substituted in 
the name entry of statements other than 
conditional assembly statements. 



For example, consider the following 
macro-definition, macro-instruction, and 
generated statements. 
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1 2 , SAVEAREA 
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-^ 



statement 1 assigns the character value 
FIELD to the SETC symbol 6PREFIX. In 
statements 2 and 3, SPREFIX is replaced by 
FIELD. 



The following example shows how the 
value assigned to a SETC symbol may be 
changed in a macro- definition. 






r 

1 Name 
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T ^ 
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_+ ^ 

1 MACRO 1 
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J 



Statement 1 assigns the character value 
FIELD to the SETC symbol 6PREFIX. There- 
fore, SPREFIX is replaced by FIELD in 
statement 2. Statement 3 assigns the char- 
acter value AREA to SPREFIX. Therefore, 
SPREFIX is replaced by AREA, instead of 
FIELD, in statement 4. 

The following example illustrates the 
use of a substring notation as the operand 
field of a SETC instruction. 
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IHERE 


jMOVE 


1 FIELDA, B 


\- 


-+ 


1 _ „ 


IHERE 


|ST 


1 2, SAVEAREA 




|L 


1 2, FIELDS 




1ST 


1 2, FIELDA 




|L 


1 2, SAVEAREA 



L X . X ,^ J 



Statement 1 assigns the substring char- 
acter value FIELD (the first five charac- 
ters corresponding to symbolic parameter 
6T0) to the SETC symbol 6 PREFIX. There- 
fore, FIELD replaces 6PREFIX in statement 
2. 



SETS — SET BINARY 



The SETB instruction may be used to assign 
the binary value or 1 to a SETB symbol. 
The form of this instruction is: 



Name 



f 

I A SETB 
I symbol 



■T -T 

I Operation I Operand 



I 
^ + _ ^ 

SETB I A or a 1,(0) or (1),| 
I or a logical ex- j 
I pression enclosed in | 

1 I parentheses j 

L L , J 



The operand may contain a or a 1 or a 
logical expression enclosed in parentheses. 
(No explicit boolean zeros or ones are 
allowed in parentheses other than in the 
form (0) or (1).) A logical expression is 
evaluated to determine if it is true or 
false; the SETB symbol in the name entry is 
then assigned the binary value 1 or cor- 
responding to true or false, respectively. 

Note ; The parentheses enclosing a logi- 
cal expression do not count towards the 
parenthesis level limit. 

A logical expression consists of one 
term or a logical combination of terms. 
The terms that may be used alone or in 
combination with each other are arittmietic 
relations, character relations, and SETB 



symbols. The logical operators used to 
combine the terms of an expression are AND, 
OR, and NOT. 



A logical expression may not contain two 
terms in succession. A logical expression 
may contain two operators in succession 
only if the first operator is either AND or 
OR and the second operator is NOT. A logi- 
cal expression may begin with the operator 
NOT. It may not begin with the operators 
AND or OR. 

An arithmetic relation consists of two 
arithmetic expressions connected by a rela- 
tional operator. A character relation 
consists of two character strings connected 
by a relational oj;>erator. The relational 
operators are EQ (equal), NE (not equal), 
LT (less than), GT (greater than), LE (lesti 
than or equal), and GE (greater than or 
equal) . 

Any expression that may be used in the 
operand of a SETA instruction, may be used 
as an arithmetic expression in the operand 
of a SETB instruction. Anything that may 
be used in the operand of a SETC instruc- 
tion, may be used as a character string in 
the operand of a SETB instruction. This 
includes substring and type attribute nota- 
tions. The maximum size of the character 
values that can be compared is 127 charac- 
ters. If the two character values are of 
unequal length, then the shorter one will 
always compare less than the longer one, 
regardless of the characters present. 

The relational and logical operators 
must be immediately preceded and followed 
by at least one blank or other S!)ecial 
character. Each relation may or may not be 
enclosed in parentheses. If a relation is 
not enclosed in parentheses, it must be 
separated from the logical operators by at 
least one blank or other special character. 

A relation enclosed in parentheses must 
not be separated from the parentheses by 
any blanks. 

The following rules apply to the use of 
variable symbols in SETB operands: 

1. If the first term starts with an apos- 
trophe, it is a character relation. 

2. If the first term starts with any char- 
acter other than an apostrophe, it is 
an arithmetic relation. 

3. It is illegal to compare a character 
expression to a character self-definintj 
term. Character expressions are valid 
in character relations. Self-defining 
terms are valid in arithmetic rela- 
tions. 
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The following are valid operand fields 
of SETB instructions: 



(SAREA+2 GT 29) 

(«AB%a' £Q '6 ALPHA*) 

(T*&ABC NE T'SXYZ) 

(T'6P12 EQ 'FM 

(6AREA+2 GT 29 OR SB) 

(NOT 6B AND 6AREA+X*2D' GT 29) 

('6C'EQ*MB') 



Logical expressions may have only three 
levels of parentheses. Subscripting, 
substring notation, and logical expression 
nesting count when determining the level of 
parentheses. The parentheses surrounding 
the SETB operand do not count. A counter 
is maintained for each statement and is 
increased by one for each occurrence of a 
variable symbol and an operation entry. 
The maximum value this counter may attain 
is 35, See Appendix H. 



The following are invalid operand fields 
of SETB instructions: 



6B 



(not enclosed in parentheses) 



(T'gP12 EQ 'F* SB) 

(two terms in succession) 
(•AB?6 4' EQ 'ALPHA* NOT 6B) 

(the NOT operator must be 
preceded by AND or OR) 
(AND T'6P12 EQ 'F') 

(expression begins with AND) 



Evaluation of Logical Expressions 



The following procedure is used to evaluate 
a logical expression in the operand field 
of a SETB instruction: 

1. Each term (i.e., arithmetic relation, 
character relation, or SETB symbol) is 
evaluated and given its logical value 
(true or false) . 

2. The logical operations are performed 
moving from left to right. However, 
NOTs are performed before ANDs, and 
ANDs are performed before ORs. 

3. The computed result is the value 
assigned to the SETB symbol in the 
name field. 

The logical expression in the operand of 
a SETB instruction may contain one or more 
sequences of logically combined terms that 
are enclosed in parentheses. A sequence of 
parenthesized terms may appear within 
another parenthesized sequence. 

The following are examples of SETB 
instruction operands that contain parenthe- 
sized sequences of terms. 

(N0T(6B AND &AREA+X'2D' GT29) ) 
(SB AND(T'&P12 EQ»F*0R&B) 

The parenthesized portion or portions of 
a logical expression are evaluated before 
the rest of the terms in the expression are 
evaluated. If a sequence of parenthesized 
terms appears within another parenthesized 
sequence, the innermost sequence is evalu- 
ated first- 



Usinq SETB Symbols 



The logical value assigned to a SETB symbol 
is used for the SETB symbol appearing in 
the operand of an AIF instruction or anoth- 
er SETB instruction. 

If a SETB symbol is used in the operand 
of a SETA instruction, or in arithmetic 
relations in the operands of AIF and SETB 
instructions, the binary values 1 (true) 
and (false) are converted to the arith- 
metic values +1 and +0, respectively. 

If a SETB symbol is used in the operand 
of a SETC instruction, in character rela- 
tions in the operands of AIF and SETB 
instructions, or in any other statement, 
the binary values 1 (true) and (false), 
are converted to the character values 1 and 
0, respectively. 

The following example illustrates these 
rules. It is assumed that L* 6T0 EQ H is 
true, and S'STO EQ is false- 
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— T 


_-j. 


— — 1 




|Name 

L 


1 Operation 

4. 


j Operand 

_ X . 


1 




r 


— ^ 


T 






1 MACRO 


1 






I6NAME 


|MOVE 
ILCLA 
1 LCLB 
ILCLC 


|&TO,6FROM 
l&Al 

1SB1,6B2 
|6C1 




1 


l&Bl 


ISETB 


1 (L'6T0 EQ U) 




2 


|6B2 


ISETB 


1 (S* STO EQ 0) 




3 


|6A1 


ISETA 


|6B1 




4 


|6C1 


I SETC 
jST 

|L 
1ST 


|'6B2* 

|2,SAVEAREA 
|2,SFR0M6A1 
|2,ST06C1 
1 2,SAVEAREA 






^ 

|HERE 

IHERE 


IWEND 

-+ 

1 MOVE 

-+ 

|ST 


1 
_^ 

1 FIELDA, FIELDB 
--I- 

1 2, SAVE AREA 


\ 










|L 


|2,FIELDB1 








1ST 


1 2 , FIELDAO 








|L 


1 2,SAVEAREA 






L 


L 


_J. . 


J 
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Because the operand of statement 1 is 
true, SBl is assigned the binary value 1. 
Therefore, the arithmetic value +1 is sub- 
stituted for SBl in statement 3, Because 
the operand of statement 2 is false, 6B2 is 
assigned the binary value 0. Therefore, 
the character value is substituted for 
6B2 in statement U. 



AIF — CONDITIONAL BRANCH 



The AIF instruction is used to alter condi- 
tionally the sequence in which source pro- 
gram statements are processed by the assem- 
bler. The typical form of this instruction 
is: 



Name 



h 



I Operation | Operand 



I A se- 
I quence | 
I symbol or | 
I not used | 



I AIF 



lA logical expression 
I enclosed in paren- 
I theses, immediately 
I followed by a 
[sequence symbol 
-J. . 



Any logical expression that may be used 
in the operand of a SETB instruction may be 
used in the operand of an AIF instruction. 
However, the forms 

AIF (0) , sequence symbol and 
AIF (1), sequence symbol 
are invalid. The sequence symbol in the 
operand must immediately follow the closing 
parenthesis of the logical expression. AIF 
operand entries must not contain explicit 
boolean zeros or ones. 

Note ; The parentheses enclosing the 
logical expression do not count toward the 
level limit - 

The logical expression in the operand is 
evaluated to determine if it is true or 
false. If the expression is true, the 
statement named by the sequence symbol in 
the operand is the next statement processed 
by the assembler; however, sequence check- 
ing is not affected. If the expression is 
false, the next sequential statement is 
processed by the assembler. 

The statement nam.ed by the sequence 
symbol may precede or follow the AIF 
instruction. 

If an AIF instruction is in a macro- 
definition, then the sequence symbol in the 
operand must appear in the name entry of a 
statement in the definition. If an AIF 
instruction appears outside macro- 
definitions, then the sequence symbol in 



the operand must appear in the name entry 
of a statement outside macro-definitions. 

The following are valid operands of AIF 
instructions: 

(6AREA+X*2D' GT 29). READER 
(T'6P12 EQ 'F'). THERE 

The following are invalid operands of 
AIF instructions: 



(T'SABC NE T'SXYZ) 

.X4F2 

(T'SABC NE T'SXYZ) 



(no sequence symbol) 

(no logical expression) 

XUF2 

(blanks between logical 
expression and se- 
quence symbol) 



The following macro-definition may be 
used to generate the statements needed to 
move a full-word fixed-point number from 
one storage area to another. The 
statements will be generated only if the 
type attribute of both storage areas is the 
letter F. 



r T T 

I Name | Operat ion | Operand 







1 MACRO 




6N 


|MOVE 


1 




|AIF 


2 




lAIF 


3 


SN 


1ST 

\L 

1ST 


U 


.END 


IMEND 



I 6T,6F 

I (T* 6T NE T' &F) .END 

I (T«6T NE 'F' ) .END 

I 2 , SAVEAREA 

|2,6F 

|2,6T 

I 2 , SAVEAREA 



The logical expression in the operand of 
statement 1 has the value true if the type 
attributes of the two macro- instruction 
operands are not equal. If the type attri- 
butes are equal, the expression has the 
logical value false. 

Therefore, if the type attributes are 
not equal, statement U (the statement named 
by the sequence symbol .END) is the next 
statement processed by the assembler. If 
the type attributes are equal, statement 2 
(the next sequential statem.ent) is proc- 
essed. 

The logical expression in the operand of 
statement 2 has the value true if the type 
attribute of the first macro-instruction 
operand is not the letter F. If the type 
attribute is the letter F, the expression 
has the logical value false. 

Therefore, if the type attribute is not 
the letter F, statement U (the statement 
named by the sequence symbol .END) is the 
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next statement processed by the assembler. 
If the type attribute is the letter F, 
statement 3 (the next sequential statement) 
is processed. 



statement 3 is the next statement processed 
by the assembler. If the type attribute is 
not the letter F, statement 2 is the next 
statement processed by the assembler. 



AGO — UNCONDITIONAL BRANCH 



The AGO instruction is used to uncondi- 
tionally alter the sequence in which source 
program statements are processed by the 
assembler. The typical form of this 
instruction is: 



Statement 2 is used to indicate to the 
assembler that the next statement to be 
processed is statement 4 (the statement 
named by sequence symbol .END). 



JName j Operation! Operand j 

I A sequence I AGO JA sequence symbol | 
j symbol or j | j 

j not used j j j 

« ± L J 



ACTR — CONDITIONAL ASSEMBLY LOOP COUNTER 



The ACTR instruction is used to limit the 
number of AGO and AIF branches executed 
within a macro- definition or within the 
main source program. 



The statement named by the sequence 
symbol in the operand is the next statement 
processed by the assembler. 

The statement named by the sequence 
symbol may precede or follow the AGO 
instruction. 

If an AGO instruction is part of a 
macro-definition, then the sequence symbol 
in the operand must appear in the name 
entry of a statement that is in that defi- 
nition. If an AGO instruction appears 
outside macro-definitions, then the 
sequence symbol in the operand must appear 
in the name entry of a statement outside 
macro-definitions . 

The following example illustrates the 
use of the AGO instruction. 



r T T 

I Name | Opera t ion | Operand 





1 MACRO 






SNAME 1 ^30VE 


6T,&F 1 


1 


|AIF 


(T'&T EQ 'FM.FIRST | 


2 


|AGO 


. END 1 


3 


.FIRST] AIF 


(T'6T NE T'SF) .END | 




&NAME 1ST 


2, SAVE ARE A | 




|L 


2,6F 1 




1ST 


2, ST 1 




|L 


2,SAVEAREA | 


tt 


.END IMEND 






1 1 J 


L J 



Statement 1 is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is the letter F, 



A separate ACTR statement may be used in 
each macro-definition and in the main pro- 
gram. These counters are independent. 



The form of this instruction is: 



r T T 1 

jName | Operation | Operand 1 

^ 1 1 ^ 

I Not used I ACTR I Any valid SETA | 
I must not I [expression | 

I be present] | ( 

L L J. J 



This statement must be the first execu- 
table statement in the macro definition or 
the main portion of the program. There- 
fore, it must immediately follow any global 
or local declarations, or, in their 
absence, the nacro prototype. This state- 
ment causes a counter to be set to the 
value in its operand. Each time an AGO or 
AIF branch is executed, the counter is 
decremented by one. If the count is zero 
before decrementing, the assembler takes 
one of two actions: 

1. If a macro definition is being proc- 
essed, the processing of it and any macros 
above it in a nest is termdnated, and the 
next statement in the main portion of the 
program is processed. 

2. If the main portion of the program is 
being processed, conditional assembly is 
terminated, and the portion of the program 
generated so far is assembled. 

If an ACTR statement is not given, the 
assumed value of the counter is 150, 
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ANOP — ASSEMBLY NO OPERATION 



The ANOP instruction facilitates condi- 
tional and unconditional branching to 
statements named by symbols or variable 
symbols. 

The typical form of this instruction is: 



r T r 

I Name [Operation | Operand 
^ 

I A se- 

j quence j 

I symbol | 

1 X 



ANOP 



-I 

I Not used, must not | 
I be present j 



If the programmer wants to use an AIF or 
AGO instruction to branch to another state- 
ment, he must place a sequence symbol in 
the name entry of the statement to which he 
wants to branch. However, if the program- 
mer has already entered a symbol or varia- 
ble symbol in the name entry of that state- 
ment, he cannot place a sequence symbol in 
the name entry. Instead, the programmer 
must place an ANOP instruction before the 
statement and then branch to the ANOP 
instruction. This has the same effect as 
branching to the statement immediately 
after the ANOP instruction. 



Statement 1 is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is not the letter F, 
statement 2 is the next statement processed 
by the assembler. If the type attribute ib 
the letter F, statement 4 should be 
processed next. However, since there is a 
variable symbol (6NAME) in the name field 
of statement U, the required sequence sym- 
bol (.FTYPE) cannot be placed in the name 
field. Therefore, an ANOP instruction 
(statement 3) must be placed before state- 
ment U. 



Then, if the type attribute of the first 
operand is the letter F, the next statement 
processed by the assenbler is the statement 
named by sequence symbol .FTYPE. The value 
of 6TYPE retains its initial null character 
value because the SETC instruction is not 
processed. Since .FTYPE names an ANOP 
instruction, the next statement processed 
by the assembler is statement U, the state- 
ment following the ANOP instruction. 



The following example illustrates the 
use of the ANOP instruction. 



I Name | Operation | Operand 



h 



-+- 







MACRO 






6 NAME 


MOVE 


6T,&F 1 






ILCLC 


&TYPE 1 


1 




|AIF 


(T'&T EQ 'F* )„ FTYPE | 


2 


6TYPE 


jSETC 


•E' 1 


3 


.FTYPE 


|ANOP 


1 


4 


&NAME 


1 STgTYPE 


2,SAVEAREA | 






ILSTYPE 


2,6F 1 






ST6TYPE 


2,&T 1 






IL&TYPE 


2 , SAVEAREA | 






MEND 






L 


L J 


L J 
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CONDITIONAL ASSEMBLY ELEMENTS 



The following chart suinmarizes the elements 
that can be used in each conditional assem- 
bly instruction. Each row in this chart 
indicates which elements can be used in a 
single conditional assembly instruction. 
Each column is used to indicate the condi- 
tional assembly instructions in which a 
particular element can be used. 



The intersection of a column and a row 
indicates whether an element can be used in 
an instruction, and if so, in what fields 
of the instruction the element can be used. 
For example, the intersection of the first 
row and the first column of the chart indi- 
cates that symbolic parameters can be used 
in the operand field of SETA instructions. 
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r T 

Variable Symbols 






SETA 






SETB 






SETC 



AIF 



ACTR 



S.P, 



SET Symbols 



SETA I SETB | SETC 



N,0 






AGO 






ANOP 



N,0 



03 



N,0 



03 



Attributes 



T' I L' I S» I !• I K' 1 N' 



O^ 



0^ 









02 



02 



02 



02 



O^ 



02 



N,0 






S.S. 



N,0 



___J L—i I L__ .J, i L— I i — 1 J 

^ Only in character relations 

2 Only in arithmetic relations 

3 Only if one to eight decimal digits 

Abbreviations 

N is Name L' is Length Attribute K' is Count Attribute 

O is Operand S' is Scaling Attribute N* is Number Attribute 

S.P. is Symbolic I' is Integer /attribute S.S. is Sequence Symbol 
Parameter 
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SECTION 10: ADDITIONAL FEATURES 



The additional features of the assembler 
language allow the programmer to: 

1, Terminate processing of a rracro- 

def inition. 
2- Generate error iressages. 

3. Define global SET symbols. 

4. Define subscripted SET symbols. 

5. Use system variable symbols. 

6. Prepare keyword and mixed-mode macro- 
definitions and write keyword and 
mixed-mode macro- instructions. 
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1 2 , SAVEAREA 
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MEXIT — MACRO-DEFINITION EXIT 



The MEXIT instruction is used to indicate 
to the assembler that it should terminate 
processing of a macro-definition. The 
typical form of this instruction is: 



^ ^ y ^ 

I Name [Operation jOperand | 

^ 1 +__ f 

I A sequence | MEXIT | Not used, | 
I symbol or j | must not be | 

[not used | [present j 

L J. J. J 



Statement 1 Is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is the letter F, the 
assembler processes the remainder of the 
macro- definition starting with statement 3. 
If the type attribute is not the letter F, 
the next statement processed by the 
assembler is statement 2. Statement 2 
indicates to the assembler that it is to 
terminate processing of the macro- 
definition. 



MNOTE STATEMENT 



The MEXIT instruction may only be used 
in a macro-definition. 

If the assembler processes an MEXIT 
instruction that is in a macro-definition 
corre^sponding to an outer macro- 
instruction, the next statement processed 
by the assembler is the next statement 
outside macro-definitions. 

If the assembler processes an MEXIT 
instruction that is in a macro-definition 
corresponding to a second or third level 
macro-instruction, the next statement proc- 
essed by the assembler is the next state- 
ment after the second or third level macro- 
instruction in the macro-definition, 
respectively. 

J^EXIT should not be confused with MEND. 
MEND indicates the end of a macro- 
definition. MEND must be the last 
statement of every macro-definition, 
including those that contain one or more 
MEXIT instructions. 

The following example illustrates the 
use of the MEXIT instruction. 



The MNOTE instruction may be used to 
generate a message and to indicate what 
error severity code, if any, is to be asso- 
ciated with the message. The typical form 
of this instruction is: 



Nam,e 



I" 



[Operation j Operand 



A sequence I MNOTE 
symbol or 
not used 



[The severity code 
[ indicator or blank, 
[followed by a comma, 
I followed by a 
[message consisting 
I of any combination 
[ of characters 
[ enclosed in 
[apostrophes 



■^ 



The operand entry of the MNOTE 
assembler-instruction may be written in one 
of the following forms: 

1. severity- code, 'message' 

2. ,' message' 

3. 'message* 



For 2 and 3 above, the severity code is 
assumed to be zero. 



The MNOTE instruction may only be used 
in a macro-definition. Variable symbols 
may be used to generate the MNOTE mnemonic 
operation code, the severity code 
indicator, and the message. 

The resulting severity code indicator 
may be a decimal integer to 255, a blank, 
or an asterisk. The integers indicate the 
severity of the error, ( is the least 
severe; 255 is the most severe). If the 
severity code indicator is blank or omit- 
ted, 1 is assumed. If the severity code is 
an asterisk, the MNOTE is not considered an 
error message, and the message is consid- 
ered a comment. Messages can be generated 
with substitution using variable symbols. 

The MNOTE statement appears in the list- 
ing with a statement number at the point 
where it was generated. If the severity 
code indicator was an integer or a blank, 
this statement number is placed in a list 
of statement numbers of MNOTE and other 
error statements near the end of the assem- 
bly listing. If the severity code is ^lti 
asterisk, the statement number is not 
placed in this list. 

Since the message portion of the MNOTE 
operand is enclosed in apostrophes, two 
apostrophes must be used to represent a 
single apostrophe. Any variable symbols 
used in the message operand are replaced by 
values assigned to them. Two ampersands 
must be used to represent a single amper- 
sand that is not part of a variable symbol. 

The following example illustrates the 
use of the MNOTE instruction. 
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Statement 1 is used to determine if the 
type attributes of both macro-instruction 



operands are the same. If they are, state- 
ment 2 is the next statement processed by 
the assembler. If they are not, statement 
5 is the next statement processed by the 
assembler. Statement 5 causes an error 
message — 8, TYPE NOT SAME — to be printed 
in the source program listing. 

Statement 2 is used to determine if the 
type attribute of the first macro- 
instruction operand is the letter F. If 
the type attribute is the letter F, 
statement 3 is the next statement processed 
by the assembler. If the attribute is not 
the letter F, statement 6 is the next 
statement processed by the assembler. 
Statement 6 causes an error message — 
8, TYPE NOT F — to be printed in the source 
program listing. Statement 4 is an MNOTE 
which is not treated as an error message. 



GLOBAL AND LOCAL VARIABLE SYMBOLS 



The following are local variable symbols: 

1. Symbolic parameters. 

2. Local SET symbols. 

3. System variable symbols. 

Global SET symbols are the only global 
variable symbols - 

The GBLA, GBLB, and GBLC instructions 
define global SET symbols, just as the 
LCLA, LCLB, and LCLC instructions define 
the SET symbols described in Section 9. 
Hereinafter, SET symbols defined by LCLA, 
LCLB, and LCLC instructions will be called 
local SET symbols. 

Global SET symbols may communicate 
values between statements in one or more 
macro-definitions and statements outside 
macro- definitions. However, local SET 
symbols communicate values between state- 
ments in the same macro-definition, or 
between statements outside macro- 
definitions. 

If a local SET symbol is defined in two 
or more macro-definitions, or in a macro- 
definition and outside macro-definitions, 
the SET symbol is considered to be a 
different SET symbol in each case. Howev- 
er, a global SET symbol is the same SET 
symbol each place it is defined. 

A SET symbol roust be defined as a global 
SET symbol in each macro-definition in 
which it is to be used as a global SET 
symbol. A SET symbol must be defined as a 
global SET symbol outside macro- 
definitions, if it is to be used as a glo- 
bal SET symbol outside macro-definitions. 
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If the same SET symbol is defined as a 
global SET symbol in one or more places, 
and as a local SET symbol elsewhere, it is 
considered the same symbol wherever it is 
defined as a global SET symbol, and a dif- 
ferent symbol wherever it is defined as a 
local SET symbol. 



macro-definition. All GBLA, GBLB, and GBLC 
instructions outside macro-definitions must 
appear before all LCLA, LCLB, and LCLC 
instructions outside macro-definitions. 



Using Global and Local SET Symbols 



Defining Local and Global GET Symbols 



Local SET symbols are defined when they 
appear in the operand entry of an LCLA, 
LCLB, or LCLC instruction. These instruc- 
tions are discussed in Section 9 under 
Defining SET Symbols . 

Global SET symbols are defined when they 
appear in the operand entry of a GBLA, 
GBLB, or GBLC instruction. The typical 
forms of these instructions are: 



Name 



J. . 

1 Not used, 
I must not 
I be present 



T T- 

I Operation | 
■i +- 



Operand 



GBLA, 
GBLB, or 
GBLC 



One or more 
variable 
symbols that 
are to be used 
as global SET 
symbols, sepa- 
rated by commas 



The GBLA, GBLB, and GBLC instructions 
define global SETA, SETB, and SETC symbols, 
respectively, and assign the same initial 
values as the corresponding types of local 
SET syiiibols. However, a glok)al SET symbol 
is assigned an initial value by only the 
first GBLA, GBLB, or GBLC instruction proc- 
essed in which the symbol appears. Subse- 
quent GBLA, GBLB, or GBLC instructions 
processed by the assembler do not affect 
the value assigned to the SET symbol. 

The programmer should not define any 
global SET symbols whose first four charac- 
ters are 6SYS. 



If a GBLA, GBLB 
part of a macro-de 
ately follow the p 
another GBLA, GBLB 
GBLA, GBLB, and GS 
macro-definitions 
macro-def init ions 
before all conditi 
tions and PUNCH an 
side macro-def init 
first control sect 



, or GBLC instruction is 
finition, it must immedi- 
rototype statement, or 
, or GBLC instruction. 
LC instructions outside 
must appear after all 
in the source program, 
onal assembly instruc- 
d REPRO statements out- 
ions, and before the 
ion of the program. 



All GBLA, GBLB, and GBLC instructions in 
a macro-definition must appear before all 
LCLA, LCLB, and LCLC instructions in that 



The following examples illustrate the use 
of global and local SET symbols. Each 
example consists of two parts. The first 
part is an assembler language source pro- 
gram. The second part shows the statements 
that would be generated by the assembler 
after it processed the statements in the 
source program. 

Example 1; This example illustrates how 
the same SET symbol can be used to communi- 
cate (1) values between statements in the 
same macro- definitions, and (2) different 
values between statements outside macro- 
definitions. 



r T T 

|Name |Operation | Operand 
^ + 1 





1 MACRO 




I6NAME 


1 LOAD A 






1 LCLA 


6A 


1 &NAME 


1 LR 


15, 6A 


16A 


|SETA 

jMEND 
1 


6A + 1 




1 
ILCLA 


SA 


1 FIRST 


1 LOAD A 






|LR 


15, 6A 




1 LOAD A 






|LR 


15, 5A 




|END 


FIRST 


L 


_j._ J 


L. __ 


r 


T r 


1 FIRST 


|LR 


15,0 




|LR 


15,0 




|LR 


15,0 




|LR 


15,0 




|END 


FIRST 



—I 



L L X . 



&A is defined as a local SETA symbol in 
a macro-definition (statement 1) and 
outside macro-def initions (statement i»>. 
6A is used twice within macro-definition 
(statements 2 and 3) and twice outside 
macro-definitions (statements 5 and 6). 

Since £A is a local SETA symbol in the 
macro-definition and outside macro- 
definitions, it is one SETA symbol in the 
macro-definition, and another SETA symbol 
outside macro-def initions- Therefore, 
statement 3 (which is in the 
macro-def init ion) does not affect the value 
used for &A in statements 5 and 6 (which 
are outside macro-definitions). 
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Example 2: This example illustrates how a 
SET symbol can be used to comraunicate 
values between statements that are part of 
a macro-definition and statements outside 
macro-definitions. 



I Name | Operation j Operand 



T 

I 
^ 







j MACRO 






6NAME 


1 LOADA 




1 




1 GBLA 


&A 


2 


&NAME 


|LR 


15, &A 


3 


6A 


iSETA 

|MEND 
1 


SA+1 


It 




1 
|GBLA 


6A 




FIRST 


1 LOADA 




5 




|LR 

1 LOADA 


15, 6A 


6 




jLR 


15, SA 






FIRST 


|END 

-+ 

|LR 


FIRST 

1- 

15,0 








|LR 


15,1 






jLR 


15,1 






|LR 


15,2 






I END 


FIRST 






I Name | Operation 
^ -j. 

MACRO 



6NAME 

SNAME 
&A 



&A 



FIRST 



j LOADA 
ILCLA 
LR 

SETA 
MEND 

MACRO 
LOADB 
LCLA 
LR 

SETA 
I MEND 

LOADA 
LOADB 
LOADA 
LOADB 
END 



1 FIRST ILR 

ILR 

LR 

ILR 
END 




SA is defined as a global SETA symbol in 
a macro-definition (statement 1) and out- 
side macro-definitions (statement U). &A 
is used twice within the macro-definition 
(statements 2 and 3) and twice outside 
macro-definitions (statements 5 and 6). 

Since 6A is a global SETA symbol in the 
macro-definition and outside macro- 
definitions, it is the same SFTA symbol in 
both cases. Therefore, statement 3 (which 
is in the macro-definition) affects the 
value used for &A in statements 5 and 6 
(which are outside macro- def initions) . 

Example 3: This example illustrates how 
the same SET symbol can be used to 
communicate I (1) values between statements 
in one macro-definition, and (2) different 
values between statements in a different 
macro-definition. 



6 A is defined as a local SETA symbol in 
two different macro-definitions (statements 
1 and 1). 6A is used twice within each 
macro-definition (statements 2,3,5 and 6). 

Since 6A is a local SETA symbol in each 
macro-definition, it is one SETA symbol in 
one macro-definition, and another SETA 
symbol in the other macro-definition. 
Therefore, statement 3 (which is in one 
macro-definition) does not affect the value 
used for SA in statement 5 (which is in the 
other macro-definition). Similarly, state- 
ment 6 does not affect the value used for 
SA in statement 2. 



Excunple 4; This example illustrates how a 
SET symbol can be used to communicate 
values between statements that are part of 
two different macro-definitions. 





1 


T "— 


-T 1 




1 Name 
f 


1 Operation 
1 MACRO 


1 Ope rand | 
1 1 






ISNAME 


1 LOADA 


1 1 


1 




[GBLA 


jSA 1 


2 


1 6 NAME 


1 LR 


|15,6A 1 


3 


|6A 


ISETA 

jMEND 

1 

1 MACRO 

1 LOADB 


1 SA+1 1 
1 1 
1 1 
1 1 
1 1 


4 




IGBLA 


ISA 1 


5 




|LR 


|15,6A 1 


6 


ISA 


1 SETA 

|MEND 
1 


jSA+l 1 

1 1 
1 1 




1 FIRST 


1 

1 LOADA 
1 LOADB 
1 LOADA 
1 LOADB 


1 1 
1 1 
1 1 
1 1 
1 1 




f 

1 FIRST 


lEND 
jLR 


1 FIRST 1 
- + ^ 

115,0 1 








ILR 


|15,1 1 






ILR 


jl5,2 1 






jLR 


|15,3 1 






|END 


1 FIRST 1 




L 


1 _ 


-J. _J 
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6A is defined as a global SETA symbol in 
two different roacro-definitions (statements 
1 and H) , SA is used twice within each 
macro-definition (statements 2,3,5, and 6). 



Since SA is a global SETA symbol in each 
macro-definition, it is the same SETA sym- 
bol in each macro-definition. Therefore, 
statement 3 (which is in one 
macro-definition) affects the value used 
for 6A in statement 5 (which is in the 
other macro-definition). Similarly, state- 
ment 6 affects the value used for 6A in 
statement 2. 



Example 5 ; This example illustrates how 
the same SET symbol can be used to coirmuni- 
cate: (1) values between statements in two 
different macro-definitions, and (2) dif- 
ferent values between statements outside 
macro-definitions. 



I Name | Operation 
^ 1 

MACRO 



j Operand 
•+ 



6NAME 

6NAME 
6A 



LOADA 

GBLA 

LR 

SETA 

MEND 



MACRO 
LOADS 
GBLA 
.LR 
6 A i SETA 
MEND 

LCLA 
FIRST i LOADA 
LOADB 
LR 

LOADA 
LOADB 
LR 
END 

FIRST I LR 
LR 
LR 
LH 
LR 
LR 
END 



— f 



6A 

15, 6A 
6A+1 



£A 

15, 6A 
gA+1 



6A 



15, 6A 



15, 6A 
FIRST 



15,0 
15,1 
15,0 
15,2 
15,3 
15,0 
FIRST 



6A is defined as a global SETA symbol in 
two different macro-definitions (statements 
1 and 4) , but it is defined as a local SETA 
symbol outside iracro-def initions (statement 
7). 6A is used twice within each macro- 
definition and twice outside macro- 
definitions (statements 2,3,5,6,8, and 9). 



Since 6A is a global SETA symbol in each 
macro- definition, it is the same SETA 
symbol in each macro-definition. However, 
since 6 A is a local SETA symbol outside 
macro-definitions, it is a different SETA 
symbol outside macro-definitions. 

Therefore, statement 3 (which is in one 
macro- definition) affects the value used 
for 6A in statement 5 (which is in the 
other macro-definition), but it does not 
affect the value used for SA in statements 
8 and 9 (which are outside 

macro-definitions). Similarly, statement 6 
affects the value used for 6 A in statement 
2, but it does not affect the value used 
for 6A in statements 8 and 9. 



Subscripted SET Symbols 



Both global and local SET symbols may be 
defined as subscripted SET symbols. The 
local SET symbols defined in Section 9 were; 
all nonsubscripted SET symbols. 

Subscripted SET symbols provide the 
programmer with a convenient way to use one 
SET symbol plus a subscript to refer to 
many arithmetic, binary, or character 
values . 

A subscripted SET symbol consists of a 
SET symbol immediately followed by a sub- 
script that is enclosed in parentheses. 
The subscript may be any arithmetic expres- 
sion that is allowed in the operand of a 
SETA statement in the range of 1 to the 
specified dimension. 

Only three levels of parentheses are 
permitted in a SETA or SETS operand. 

The following are valid subscripted SET 
symbols. 

6READER(17) 

£A23U56(6S4) 

SXUF2(25+6A2) 

The following are invalid subscripted 
SET symbols. 



6X4F2 
(25) 
6X4F2 (25) 



(no subscript) 
(no SET symbol) 
(subscript does not 

immediately follow 

SET symbol) 



Defining Subscripted SET Symbols; If the 
programmer wants to use a subscripted SET 
symbol, he must write in a GBLA, GBLB, 
GBLC, LCLA, LCLB, or LCLC instruction, a 
SET symbol immediately followed by an 
unsigned decimal integer enclosed in paren- 
theses. The decimal integer, called a 
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dimension, indicates the number of SET 
variables associated with the SET syrabol. 
Every variable associated with a SET symbol 
is assigned an initial value that is the 
same as the initial value assigned to the 
corresponding type of nonsubcripted SET 
symbol. 

If a sutecripted SET symbol is defined 
as global, the same dimension must be used 
with the SET symbol each time it is defined 
as global. 



and &TSW(9), respectively. Statements 4 
and 5 generate sta tenants that add the 
value assigned to £SBOX(45) to general 
register 2, and compare the value assigned 
to 6WBOX(17) to the value stored at AREA, 
respectiveiy- 



SYSTEM VARIABLE SYMBOLJ 



The maximum dimension that can be used 
with a SETA, SETB, or SETC symbol is 255. 

A subscripted SET symbol may be used 
only if the declaration was subscripted. A 
nonsubscripted SET symbol may be used only 
if the declaration had no subscript. 



The following statements define the 
global SET symbols SSBOX, &WBOX, and SPSW, 
and the local SET symbol 6TSW. SSBOX has 
50 arithmetic variables associated with it, 
&WBOX has 20 character variables, SISW and 
6TSW each have 230 binary variables. 



System variable symbols are local variable 
symbols that are assigned values automat- 
ically by the assembler. There are three 
system variable symbols: SSYSNDX, 6SYSECT, 
and gSYSLIST. System variable symbols may 
be used in the name, operation and operand 
entries of statements in macro-definitions, 
but not in statements outside macro- 
definitions. They may not be defined as 
symbolic parameters or SET symbols, nor may 
they be assigned values by SETA, SETB, and 
SETC instructions. 






J. ^ ^ 

I Name | Operation | Operand 

I IGBLA |6SBOX(50) 
I |GBLC |£WBOX(20) 
I jGBLB 1SPSWC230) 
I JLCLB |STSW(230) 

U J J. 



Using Subscripted SET Symbols: After the 
programmer has associated a number of SET 
variables with a SET symbol, he may assign 
values to each of the variables and use 
them in other statements. 



&SYSNDX — Macro- Instruction Index 



The system variable symbol SSYSNDX may be 
combined with other characters to create 
unique names for statements generated from 
the same model statement. 



6SYSNDX is assigned the four-digit 
number 0001 for the first macro- instruction 
processed by the assembler, and it is 
incremented by one for each subsequent 
inner and outer macro- instruction i)roc- 
essed. 



If the statements in the previous exam- 
ple were part of a macro-definition, (and 
6 A was defined as a SETA symbol in the same 
definition), the following statements could 
be part of the same macro- definition. 



Name 



^■ 



■T T 

I Operation | Operand 



1 


1 &A 


ISETA 


|5 1 


2 


|6PSW(6A) 


|SETB 


1 (6 LT 2) j 


3 


1 STSWO) 


ISETB 


1 (SPSWCSA)) 1 


4 


1 


|A 


1 2,=F'&SBOX(45) • 1 


5 


1 


|CLI 


|AREA,C'6WBOX(17> ' | 




L 


-X 


± , J 



If SSYSNDX is used in a model statement, 
SETC or MNOTE instruction, or a character 
relation in a SETB or AIF instruction, the 
value substituted for SSYSNDX is the four- 
digit number of the macro-instruction being 
processed, including leading zeros. 

If &SYSNDX appears in arithmetic 
expressions (e.g., in the operand of a SETA 
instruction) , the value used for &SYSNDX is 
an arithmetic value. 

Throughout one use of a macro defini- 
tion, the value of 6SYSNDX may be consid- 
ered a constant, independent of any inner 
macro- instruct! on in that definition- 



Statement 1 assigns the arithmetic value 
5 to the nonsubscripted SETA symbol &A. 
Statements 2 and 3 then assign the binary 
value to subscripted SETB symbols 6PSW(5) 



The example in the next column illus- 
trates these rules. It is assumed that the 
first macro- instruction processed, OUTER 1, 
is the 106th macro-instruction processed by 
the assembler. 
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statement 7 is the 106th macro- 
instruction processed. Therefore, 6SYSNDX 
is assigned the number 0106 for that macro- 
instruction. The number 0106 is 
substituted for 6SYSNDX when it is used in 
statements U and 6, Statement U is used to 
assign the character value 0106 to the SETC 
symbol 6NDXNUM. Statement 6 is used to 
create the unique name B0106. 



[Name 



[Operation 
■+- 



[Operand 
■+- 





1 MACRO 






1 INNERl 






1 GBLC 


6NDXNUM 


A6SYSNDX 


jSR 


2,5 




|CR 


2,5 




|BE 


B6NDXNUM 




|B 


A6SYSNDX 




1 MEND 
1 






1 

1 MACRO 




6NA^5E 


1 OUTERl 






1 GBLC 


6NDXNUM 


6NDXNUM 


JSETC 


•SSYSNDX' 


6NAME 


|SR 


2,4 




|AR 


2,6 




1 INNERl 




B6SYSNDX 


|S 

|MEND 
_x 


2,=F'1000' 




T 





ALPHA 


[OUTERl 




BETA 


[OUTERl 






-+ 





ALPHA 


[SR 


2,4 




|AR 


2,6 


A0107 


[SR 


2.5 




JCR 


2,5 




[BE 


B0106 




IB 


A0107 


BO 10 6 


IS 


2,=F'1000' 


BETA 


[SR 


2,4 




1 AR 


2,6 


A0109 


[SR 


2,5 




|CR 


2,5 




[BE 


B0108 




|B 


A0109 


BO 10 8 


|s 


2,=F'1000' 



L J. X J 



When statement 5 is used to process the 
10 8th macro-instruction, statement 5 
becomes the 109th macro-instruction proc- 
essed. Therefore, each occurrence of 
SSYSNDX is replaced by the number 0109. 
For example, statement 1 is used to create 
the unique name A0109. 



eSYSECT — Current Control Section 



The system variable symbol 6SYSECT may be 
used to represent the name of the control 
section in which a macro- instruction 
appears. For each inner and outer macro- 
instruction processed by the assembler, 
6SYSECT is assigned a value that is the 
name of the control section in which the 
macro- instruction appears. 

When 6SYSECT is used in a macro- 
definition, the value substituted for 
SSYSECT is the name of the last CSECT, 
DSECT, or START statement that occurs 
before the macro- instruction. If no named 
CSECT, DSECT, or START Statements occur 
before a macro-instruction, &SYSECT is 
assigned a null character value for that 
ma cr o- i ns t rue t i on . 

CSECT or DSECT Statements processed in a 
macro- definition affect the value for 
SSYSECT for any subsequent inner macro- 
instructions in that definition, and for 
any other outer and inner macro- 
instructions. 



Throughout the use of a macro- 
definition, the value of 6SYSECT may be 
considered a constant, independent of any 
CSECT or DSECT Statements or inner macro- 
instructions in that definition. 

The next example illustrates these 
rules. 



Statement 5 is the 107th macro- 
instruction processed. Therefore, 6SYSNDX 
is assigned the number 0107 for that macro- 
instruction. The number 0107 is 
substituted for 6SYSNDX when it is used in 
statements 1 and 3. The number 0106 is 
substituted for the global SETC symbol 
&r®XNUM in statement 2, 



Statement 8 is the 108th macro- 
instruction processed. Therefore, each 
occurrence of SSYSNDX is replaced by the 
num.ber 0108- For example, statement 6 is 
used to create the unique name B010 8. 



Statement 8 is the last CSECT, DSECT, or 
START Statement processed before statement 
9 is processed. Therefore, &SYSECT is 
assigned the value MAINPROG for macro- 
instruction OUTERl in statement 9. 
MAIKPROG is substituted for SSYSECT when it 
appears in statement 6. 



Statement 3 is the last CSECT, DSECT, or 
START statement processed before statement 
4 is processed. Therefore, 6SYSECT is 
assigned the value CSOUTl for macro- 
instruction INNER in statement 4. CSOUTl 
is substituted for SSYSECT when it appears 
in statement 2. 
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statement 1 is used to generate a CSECT 
statement for statement U , This is the 
last CSECT, DSECT, or START Statement that 
appears before statement 5. Therefore, 
6SYSECT is assigned the value INA for 
macro-instruction INNER in statement 5, 
INA is substituted for 6SYSECT when it 
appears in statement 2. 

j Name | Operat ion j Operand | 



9 
10 



^ 





1 MACRO 


1 1 




1 INNER 


g INCSECT j 


I6INCSECT 


i CSECT 






|DC 


A(SSYSECT) 1 




1 MEND 






1 MACRO 






j OUTERl 


1 


1 CSOUTl 


1 CSECT 






I OS 


lOOC 1 




1 INNER 


INA 1 




[INNER 


INB 1 




|DC 


A(gSYSECT) 1 




1 MEND 






1 MACRO 






1 0UTER2 


1 




|DC 


A(6SYSECT) 1 


f 

IMAINPROG 


JMEND 
ICSECT 


^ j 




JDS 


200C 1 




j OUTERl 






1 OUTER 2 




\- 


_| . 


-1 


JMAINPROG 


i CSECT 






IDS 


200C 1 


1 CSOUTl 


I CSECT 






IDS 


lOOC 1 


|INA 


1 CSECT 






|DC 


A (CSOUTl) 1 


|INB 


1 CSECT 






|DC 


A (INA) 1 




|DC 


A(MAINPROG) 1 




I DC 


A (INB) I 



6SYSLIST and symbolic parameters may be 
used in the same macro-definition. 

SSYSLIST(n) may be used to refer to the 
nth macro-instruction operand. In 
addition, if the nth operand is a sublist, 
then 6SYSLIST(n,m) may be used to refer to 
the mth operand in the sublist, where n and 
m may be any arithmetic expressions allowed 
in the operand field of a SETA statement. 

When n is equal to zero, a null operand 
results. When n is from 1 to 100, the 
value of the operand is given (providing an 
operand exists corresponding to n) . An 
error results when n is greater than 100. 

The type, length, scaling, integer, and 
count attributes of 6SYSLIST(n) and 
6SYSLIST(n,m) and the number attributes of 
6SYSLIST(n) and 6SYSLIST may be used in 
conditional assembly instructions. 
N*6SYSLIST may be used to refer to the 
total number of operands in a macro- 
instruction statement. N* SSYSLIST(n) may 
be used to refer to the number of operands 
in a sublist. If the nth operand is 
omitted, N' is zero; if the nth operand is 
not a sublist, N* is one. 

The following procedure is used to 
evaluate N'SSYSLIST: 

1. A sublist is considered to be one 
operand. 

2. The number of operands efjpaals one plus 
the number of commas indicating the 
end of an operand. 

Note : &SYSLIST can be used to access 
parameters without a corresponding symbolic 
parameter appearing in the prototype. 

Attributes are discussed in Section 7 
under Attributes, 



Statement 1 is used to generate a CSECT 
statement for statement 5. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 10. Therefore, 
&SYSECT is assigned the value INB for 
macro-instruction OUTER 2 in statement 10. 
INB is substituted for &SYSECT when it 
appears in statement 7. 



&SYSLIST — Macro-Instruction Operand 



The system variable symbol &SYSLIST pro- 
vides the programmer with an alternative to 
symbolic parameters for referring to macro- 
instruction operands. 



KEYWORD MACRO-DEFINITIONS AND INSTRUCTIONS 



Keyword macro-definitions provide the pro- 
grammer with an alternate way of preparing 
ma cro- def init ions - 

A keyword macro- def inition enables a 
programmer to reduce the number of operands 
in each macro- instruct ion that corresponls 
to the definition, and to write the oper- 
ands in any order. 

The macro- instructions that correspond 
to the macro- definitions described in Sec- 
tion 7 (hereinafter called positional 
macro-instructions and positional macro- 
definitions, respectively) require the 
operands to be written in the same order as 
the corresponding symbolic parameters in 
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the operand entry of the prototype 
statement. 



In a keyword macro-definition, the pro- 
grammer can assign values to any symbolic 
parameters that appear in the operand of 
the prototype statement. The value 
assigned to a symbolic parameter is substi- 
tuted for the symbolic parameter, if the 
programmer does not write anything in the 
operand of the macro-instruction to corres- 
pond to the symbolic parameter. 

When a keyword macro-instruction is 
written, the programmer need only write one 
operand for each symbolic parameter whose 
value he wants to change. 

Keyword macro-definitions are prepared 
the same way as positional macro- 
definitions, except that the prototype 
statement is written differently, and 
SSYSLIST may not be used in the definition. 
The rules for preparing positional macro- 
definitions are in Section 7. 



The following are invalid keyword proto- 
type operands. 



CARDAREA 
STYPE 
6TW0 =123 



6AREA= X'189A' 



(no symbolic parameter) 
(no equal sign) 
(equal sign does not 

immediately follow 

symbolic parameter) 
( value does 

not immediately follow 

equal sign) 



The following keyword prototype state- 
ment contains a symbolic parameter in the 
name entry and four operand entries in the 
operand. The first two operand entries 
contain values. The mnemonic operation 
code is MOVE. 



r T r 1 

I Name | Operation | Operand | 

^ + 1 ^ 

|6N I MOVE I SR = 2,6A=S,&T=,6F= j 

L X J. J 



Keyword Prototype 



The typical form of this statement is; 



Name 



h 



j Operation j Operand 



A symbolic 
parameter 
or not used 



A symbol jone to 100 

[operands of the 
[form described 
I below, separated 
I by commas 

L 



H 



Each operand must consist of a symbolic 
parameter, immediately followed by an equal 
sign and optionally followed by a value. 
Nested keywords are not permitted. 

A value that is part of an operand must 
immediately follow the equal sign. 

Anything that may be used as an operand 
in a macro-instruction except variable 
symbols, may be used as a value in a 
keyword prototype statement. The rules for 
forming valid macro-instruction operands 
are detailed in Section 8 . 

The following are valid keyword proto- 
type operands. 

6READER= 

&LOOP2=SYMBOL 

6S4==F'4096' 



Keyword Macro-Instruction 



After a programmer has prepared a keyword 
macro-definition he may use it by writing a 
keyword macro-instruction. 

The typical form of a keyword macro- 
instruction is: 



j Operation) Operand 



H 



I Name 

|A symbol, I Mnemonic |Zero or more operands) 
I sequence | operation] of the form described) 
jsymbol,or j code j below, separated by j 
jnot used ) j commas j 

L X J J 



Each operand consists of a keyword 
imjnediately followed by an equal sign and 
an optional value. Nested keywords are not 
permitted. Anything that may be used as an 
operand in a positional macro-instruction 
may be used as a value in a keyword macro- 
instruction. The rules for forming valid 
positional macro- instruction operands are 
detailed in Section 8 . 

A keyword consists of one through seven 
letters and digits, the first of which must 
be a letter. 

The keyword part of each keyword macro- 
instruction operand must correspond to one 
of the symbolic parameters that appears in 
the operand of the keyword prototype 
statement. A keyword corresponds to a 
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symbolic parameter if the characters of the 
keyword are identical to the characters of 
the symbolic parameter that follow the 
ampersand. 

The following are valid keyword macro- 
instruction operands. 

LOOP2=SYMBOL 

SH==FM096' 

TO= 

The following are invalid keyword macro- 
instruction operands. 



&X4F2-0(2,3) 



CARDAREA=A+2 



=(T0(8) , (FROM)) 



(keyword does not begin 

with a letter) 
(keyword is more than 

seven characters) 
(no keyword) 



The operands in a keyword macro- 
instruction may be written in any order. 
If an operand appeared in a keyword 
prototype statement, a corresponding oper- 
and does not have to appear in the keyword 
macro-instruction. If an operand is omit- 
ted, the comma that would have separated it 
from the next operand need not be written. 

The following rales are used to replace 
the symbolic parameters in the statements 
of a keyword macro-definition. 

1. If a symbolic parameter appears in the 
name entry of the prototype statement, 
and the name entry of the macro- 
instruction contains a symbol, the 
symbolic parameter is replaced by the 
symbol. If the name entry of the 
macro-instruction is unused or contains 
a sequence symbol, the symbolic param- 
eter is replaced by a null character 
value. 

2. If a symbolic parameter appears in the 
operand of the prototype statement, and 
the macro-instruction contains a key- 
word that corresponds to the symbolic 
parameter, the value assigned to the 
keyword replaces the symbolic paramet- 
er, 

3. If a symbolic parameter was assigned a 
value by a prototype statement, and the 
macro- instruction does not contain a 
keyword that corresponds to the symbol- 
ic parameter, the standard value 
assigned to the symbolic parameter 
replaces the symbolic parameter. Oth- 
erwise, the symbolic parameter is 
replaced by a null character value. 

Note: If a symbolic parameter value is a 
self-defining term the type attribute 
assigned to the value is the letter N. If 
a symbolic parameter value is omitted the 
type attribute ass igneei to the value is the 



letter O, All other values are assigned 
the type attribute U. 

The following keyword macro-definition, 
keyword macro-instruction, and generated 
statements illustrate these rules. 

Statement 1 assigns the values 2 and S 
to the symbolic parameters SR and &A, res- 
pectively. Statement 6 assigns the values 
FA, FB, and THERE to the keywords T, F, and 
A, respectively. The symbol HERE is used 
in the name entry of statement 6. 

Since a symbolic parameter (6N) appears 
in the name entry of the prototype state- 
ment (statement 1), and the corresponding 
characters (HERE) of the macro- instruction 
(statement 6) are a symbol, &N is replaced 
by HERE in statement 2 . 





I 


-T 


— P _ 


, 




[Name 
i 


1 Operation 
_ 1 


1 Operand 


1 
J 






t — 
1 MACRO 


1 


1 


1 


|6N 


jMOVE 


|6R=2,gA=S,gT=,6F= 




2 


|SN 


1ST 


1SR,6A 




3 




)L 


1 £R , €F 




^ 




1ST 


1£R,&T 




5 




JMEND 


1 6R,6A 
1 






f 


_| 


_+ _ 


—- 1 


6 


1 HERE 

L . 


jMOVE 
-4. — 


J T=F A , F=F B , A=THERE 
_^ 


~H 




r — 


t 




1 HERE 


1ST 

IL 

1ST 


1 2, THERE 
|2,FB 
12, FA 
j 2 , THERE 






L_ — 


-JL 


_,1,____-. __——_—_—_____- 


J 



since 6T appears in the operand of 
statement 1, and statement 6 contains the 
keyword (T) that corresponds to ST, the 
value assigned to T (FA) replaces 6T in 
statement U. Similarly, FB and THERE 
replace 6F and SA in statement 3 and in 
statements 2 and 5, respectively. bJote 
that the value assigned to £A in statement 
6 is used instead of the value assigned to 
6A in statement 1. 

Since SR appears in the operand of 
statement 1, and statement 6 does not con- 
tain a corresponding keyword, the value 
assigned to 6R (2), replaces SR in state- 
ments 2, 3, 4, and 5. 



Operand Sublists: The value assigned to a 
keyword and the value assigned to a symbol- 
ic parameter may be an operand sublist. 
Anything that may be used as an operand 
sublist in a positional macro- instruct ion 
may be used as a value in a keyword macro- 
instruction and as a value in a keyword 
prototype statement. The rules for forming 
valid operand sublists are detailed in 
Section 8 under "Operand Sublists." 
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Keyword Inner Macro- Instructions; Keyword 
and positional inner macro-instructions may 
be used as model statements in either 
keyword or positional macro-definitions. 



Mixed-Mode Macro- Instruction 



The typical form of a mixed-mode macro- 
instruction is: 



I Operation! Operand 



MIXED-MODE MACRO-DEFINITIONS AND 
INSTRUCTIONS 



Mixed-mode macro-definitions allow the 
programmer to use the features of keyword 
and positional macro-definitions in the 
same macro-definition. 



Mixed-mode macro-definitions are pre- 
pared the same way as positional macro- 
definitions, except that the prototype 
statement is written differently, and 
6SYSLIST may not be used in the definition. 
The rules for preparing positional macro- 
definitions are in Section 7. 



Mixed-Mode Prototype 



The typical form of this statement is: 



J. . p J. -, 

j Name [Operation | Operand | 

I A symbolic JA symbol |Two to 100 oper- 

I parameter j | ands of the form 

I or not used] j described below, 

I i I separated by 

I I I commas 



The operands must be valid operands of 
positional and keyword prototype 
statements. All the positional operands 
must precede the first keyword operand. 
The rules for forming positional operands 
are discussed in Section 7 under Macro- 
Instruction Prototype . The rules for 
forming keyword operands are discussed 
under Keyword Prototype . 

The following sample mixed- mode proto- 
type statement contains three positional 
operands and two keyword operands. 



r T T T 

I Name | Operation {Operand | 

I &N I MOVE j6TY,SP,6R,eTO=,6F= f 

L L L 1 



jName 
f 

I A symbol, [Mnemonic |Zero or more oper- 
I sequence | operation} ands of the form 

I symbol, or I code | described below, 

I not used | j separated by 

j j j commas 



The operand consists of two parts. The 
first part corresponds to the positional 
prototype operands. This part of the 
operand is written in the same way that the 
operand entry of a positional macro- 
instruction is written. The rules for 
writing positional macro-instructions are 
in Section 8 . 

The second part of the operand 
corresponds to the keyword prototype oper- 
ands. This part of the operand is written 
in the same way that the operand entry of a 
keyword macro- instruct ion is written. The 
rules for writing keyword macro- 
instructions are described under Keyword 
Macro- Instruct ion . 

The following mixed-mode macro- 
definition, mixed-mode macro-instruction, 
and generated statements illustrate these 
facilities. 



JNaroe ) Operation) Operand 
^ 1 + 

t I MACRO I 

i&N I MOVE 

J6N [STSTY 

i JLgTY 

i JSTSTY 

I IL6TY 

I ^ 1 ^ 

JHERE I MOVE | H, , 2 , F=FB,TO=FA | 

^HERE [STH I 2, SAVE \ 

I |LH I 2,FB 1 

j JSTH I 2, FA I 

j |LH I 2, SAVE j 

i. J i J 



STY, &P, 6R, &TO=, 6F= 

&R,SAVE 

SR,6PSF 

SR,SP6TO 

6R,SAVE 



The prototype statement (statement 1) 
contains three positional operands (6TY,SP, 
and 6R) and two keyword operands (STO and 
6F). In the macro-instruction (statement 
2> the positional operands are written in 
the same order as the positional operands 
in the prototype statement (the second 
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operand is omitted). The keyword operands 
are written in an order that is different 
from the order of keyword operands in the 
prototype statement. 

Mixed-mode inner macro-instructions may 
be used as model statements in mixed-mode, 
keyword, and positional macro-definitions. 
Keyword and positional inner macro- 
instructions may be used as model 
statements in mixed-mode macro-definitions. 



Basic Operating System/360 Assembler (16K 
Disk/Tape) provided that all SET symbols 
are defined in an appropriate LCLB, GBLA, 
GBLB, or GBLC Statement. The AIFB and AGOB 
instructions are processed by the Basic 
Operating System/360 Assembler (16K 
Disk/Tape) the same way that the AIF and 
AGO instructions are processed. AIFB and 
AGOB instructions cause the count set up by 
the ACTR instruction to be decremented 
exactly like the AGO and AIF instructions. 



CONDITIONAL ASSEMBLY COMPATIBILITY 



Macro-definitions prepared for use with the 
other System/360 assemblers having macro 
language facilities may be used with the 
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APPENDIX A: EXTENDED BINARY CODED DECIMAL INTERCHANGE CODE (EBCDIC) 



The following charts and the associated key 
show the bit configurations of the 256 
possible codes (characters) of the Extended 
BCD Interchange Code. To write a given 
character in binary, locate the character 
on the chart. The top row of coordinates 
equates to bit positions and 1, the sec- 
ond row to bit positions 2 and 3, and the 
left row of coordinates equates to bit 
positions 4, 5, 6 and 7. 

Examples ; 

Character A equals: 

top row - 11 (bit positions 0, 1) 

2nd row - 00 (bit positions 2, 3) 

left row - 0001 (bit positions U, 5, 6 
and 7) 

Therefore, character A is shown as: 1100 
0001. 

Character $ equals: 

top row - 01 (bit positions 0, 1) 

2nd row - 01 (bit positions 2, 3) 

left row - 1011 (bit positions k , 5, 6 
and 7) 



Therefore, character $ is shown as: 
0101 1011- 



The coordinates on the bottom of the 
chart are the three zone punches required 
to reproduce the character in a punched 
card; the coordinates on the right side 
represent the numeric punches. 



Examples : 



Character A = bottom row - 12 punch 
right row - 1 punch 

Therefore, Character A is shown by a 12 
and a 1 punch in the same card column. 



Character $ = bottom row - 11 punch 

right row - 8 and 3 punches 

Therefore, Character $ is shown by 11, 
8, and 3 punches in the same card coluir.n. 

There are fifteen exceptions to the 
punching equated to bit positions. These 
exceptions are shown in the chart by cir- 
cled numbers 1 through 15, and the substi- 
tuted punching is shown below the chart 
under Exceptions . 



100 



0000 



0001 



0010 



0011 



0100 



0101 



Olio 



0111 



1000 



1001 



1010 



i on 
110b 



1101 



1110 

nil 









1 


01 


Bit Positions 


UU 1 


0, 1 


00 


voiv 


10 


11 


00 


;;Qff 


/■tM5y!5: 


Bit Positions 


2,3 



Q 


O 


.^ 


a 


.^ 


.^ 


(J) ■ s: 






SOS 








^3\ 




-- 


FS 




' 










JPF 
HT 


RES 


BYP 


PN 








NL 


LF 


RS 








LC 


BS 


EOB 


UC 








DEL 


IL 


PRE 


EOT 




















O o 

1 ^^ 



a 



9; 9 


9 


9 


J2 , 12 




12 


1 n 


11 


11 


0; 














■ 1 





nn 




m 


Bit Positions 


"^ J 




0, 1 


00 


fffi 


10 11 

i 


00 


M: 


lllfi 


Bit Positions 


2, 3 



SM 



15, 



.@ 



is:;^™*^- 



a-^rj 



jBgJ": 





t^ 


to 


^ 


<1> 


^ 






U 

c 


10 


. 3 

a. 


», 


'Sf 


.»_ 


tf» ■ 


O) 


C 



Q 


'^ 













a. 




.^^ 








ca 



0000 



QOOJ 



0010 



0011 



0100 



QlOl 



9 ! 9 
•12! 



12 



n 
J p_ 



Zone Punches 



0110 



oin 



1000 



1001 



1,010 



1011 



1100 



1101 



1110 



nil 



WBj 






1 










Bit Positions 


mmmvmm 




0, 1 


lii 




:Jlft> 


11 


00 


01: 


10 


n 


Bit Positions 


2, 3 











(!) 


H 


(n) 


„<^ 


a 


i 






A 


J 


(14; 


' 


b 


k 


s 




B 


K 


s 


2 


c 


1 


t 




C 


L 


T 


3 

4 
5 


d 

e 
f 


m 
n 


u 




D 


M 
N 


U 
V 


V 




E 





w 

X 

y 


— 


F 





W 


6 


g 


P 


G 
H 


P 
Q 


X 


7 


h 


q 


Y i 8 


i r i z 


1 


R 


Z 9 



*,?■-<,-"'- 


;. . - 


1 12 


1 
12 ' 








QT' 


n i 11 


1 11 






■r?«( 


.,.». 


! 


1 







^ -r „ 1 












' 











„ 


Bit Positions 


J 




0, 1 


00 


Al- 


io 


11 


00 


i or /rij n. 


Bit Positions 


2, 3 



\ 



■- 




1 


9 9 


9 , 


9 


-,42.., 


12 


, '2 


12 12 ! 




12 




11 


11 ' 11 


11 


11 


11 


^m:. 




























■| 



(T) 12-0-9-8-1 

(2) 12-11-9-8-1 

(3) 11-0-9-8-1 
12-11-0-9-8-1 



(5^ No Punches 
(6) 12 

(s) 12-11-0 



(9) 12-0 

(To) 11-0 

(n) 0-8-2 

(g) 



(13) 0-1 
(g) 11-0-9-1 
(g) 12-11 
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Contro 


1 Characters 












PF 


'unch Off 


BS Backspace 






PN Punch On 




HT 


Horizontal Tab 


IL Idle 






RS Reader Stop 




LC 


.ower Case 


BY Bypass 






UC Upper Case 




DL 


Delete 


LF Line Feed 






ET End of Transmission 




RE 


Restore 


EB End of Block 






SM Set Mode 




NL 


^ew Line 


PR Prefix 






SP Space 




DS 


Digit Select 


SOS Start of Signif 


icance 




FS Field Separator 




Spec! a 


Graphic Characters 










c 


Cent S 


ign ^ 


" Asterisk 




> 


Greater-than Sign 




Period 


, Decimal Point 


) Right Parenthesis 




? 


Question Mark 


< 


Less-th 


an Sign 


; Semicolon 






Colon 


( 


Left Parenthesis —i Logical NOT 




# 


Number Sign 


+ 


Plus Si 


gn 


■ Minus Sign, Hyphen 




@ 


At Sign 


1 


Vertical Bar, Logical OR / Slash 




1 


Prime, Apostrophe 


& 


Ampersand 


' Comma 




= 


Equal Sign 


1 


Exclamation Point % Percent 




" 


Quotation Mark 


$ 


Dcul lar 


Sign 


Underscore 














Bit Pattern ' 








Hole Pattern 


Examples 


Type- 


Bit P'OsitTons 


























01 23 4567 




Zone P>unches 


Digit Punches 


PF 


Control Character 


00 00 01 00 


12-9-4 1 


% : 


Special Graphic 


01 10 MOO 


0- 


-8-4 


R 


Upper Case 


1:1 01 100T 


n ■ 


-9 




a 


Lower Case 


10 00 0001 


12-0- 


- 1 






Control Character,, 


00 1 1 0000 




12- 


13 - 


-9- 


■8-1 






function not yet 


















assigned 










1 
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APPENDIX B: HEXADECIMAL- DECIMAL NUMBER CONVERSION TABLE 



The table in this appendix provides for 
direct conversion of decimal cind hexadeci- 
mal numbers in these ranges: 

I Hexadecimal | Decimal | 
|. ^... _^ 

) 000 to FFF I 0000 to 4095 | 

I ± J 

Decimal numbers (0000-4095) are given with- 
in the 5-part table. The first two charac- 
ters (high-order) of hexadecimal numbers 
(000-FFF) are given in the lefthand column 
of the table; the third character (x) is 
arranged across the top of each part of the 
table. 

To find the decimal equivalent of the 
hexadecimal number 0C9, look for OC in the 
left column, and across that row under the 
column for x = 9. The decimal number is 
0201. 

To convert from decimal to hexadecimal, 
look up the decimal number within the table 
and read the hexadecimal number by a combi- 
nation of the hex characters in the left 
column, and the value for x at the top of 
the column containing the decimal number. 



For example, the decimal number 123 has the 
hexadecimal equivalent of 07B; the decimal 
number 1478 has the hexadecimal equivalent 
of 5C6, 

For numbers outside the range of the 
table, add the following values to the 
table 



r- 

1 


Hexadecimal 


1 


Decimal 


1 


1-- 


1000 
2000 
3000 
4000 
5000 
6000 
7000 
8000 
9000 
AOOO 
BOOO 
COOO 
DOOO 
EOOO 
FOOO 


-+- 


4096 
8192 
12288 
16384 
20480 
24576 
28672 
32768 
36864 
40960 
4 5056 
49152 
53248 
57344 
61440 


-i 


t_ 




_X_ 




_j 
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X = 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


OOx 


0000 


0001 


0002 


0003 


0004 


0005 


0006 


0007 


0008 


0009 


0010 


0011 


0012 


0013 


0014 


0015 


Olx 


0016 


0017 


0018 


0019 


0020 


0021 


0022 


0023 


0024 


0025 


0026 


0027 


0028 


0029 


0030 


0031 


02x 


0032 


0033 


0034 


0035 


0036 


0037 


0038 


0039 


0040 


0041 


0042 


0043 


0044 


0045 


0046 


0047 


03x 


0048 


0049 


0050 


0051 


0052 


0053 


0054 


0055 


0056 


0057 


0058 


0059 


0060 


0061 


0062 


0063 


04»X 


0064 


0065 


0066 


0067 


0068 


0069 


0070 


0071 


0072 


0073 


0074 


0075 


0076 


0077 


0078 


0079 


05x 


0080 


0081 


0082 


0083 


0084 


0085 


0086 


0087 


0088 


0089 


0090 


0091 


0092 


0093 


0094 


0095 


06x 


0096 


0097 


0098 


0099 


0100 


0101 


0102 


0103 


0104 


0105 


0106 


0107 


0108 


0109 


0110 


0111 


07x 


0112 


0113 


0114 


0115 


0116 


0117 


0118 


0119 


0120 


0121 


0122 


0123 


0124 


0125 


0126 


0127 


08x 


0128 


0129 


0130 


0131 


0132 


0133 


0134 


0135 


0136 


0137 


0138 


0139 


0140 


0141 


0142 


0143 


09x 


014U 


0145 


0146 


0147 


0148 


0149 


0150 


0151 


0152 


0153 


0154 


0155 


0156 


0157 


0158 


0159 


OAx 


0160 


0161 


0162 


0163 


0164 


0165 


0166 


0167 


0168 


0169 


0170 


0171 


0172 


0173 


0174 


0175 


OBx 


0176 


0177 


0178 


0179 


0180 


0181 


0182 


0183 


0184 


0185 


0186 


0187 


0188 


0189 


0190 


0191 


OCX 


0192 


0193 


0194 


0195 


0196 


0197 


0198 


0199 


0200 


0201 


0202 


0203 


0204 


0205 


0206 


0207 


ODx 


0208 


0209 


0210 


0211 


0212 


0213 


0214 


0215 


0216 


0217 


0218 


0219 


0220 


0221 


0222 


0223 


OEx 


0224 


0225 


0226 


0227 


0228 


0229 


0230 


0231 


0232 


0233 


0234 


0235 


0236 


0237 


0238 


0239 


OFx 


0240 


0241 


0242 


0243 


0244 


0245 


0246 


0247 


0248 


0249 


0250 


0251 


0252 


0253 


0254 


0255 


lOx 


0256 


0257 


0258 


0259 


0260 


0261 


0262 


0263 


0264 


0265 


0266 


0267 


0268 


0269 


0270 


0271 


11x 


0272 


0273 


0274 


0275 


0276 


0277 


0278 


0279 


0280 


0281 


0282 


0283 


0284 


0285 


0286 


0287 


12x 


0288 


0289 


0290 


02 91 


0292 


0293 


0294 


0295 


0296 


0297 


0298 


0299 


0300 


0301 


0302 


0303 


13x 


0304 


0305 


0306 


0307 


0308 


0309 


0310 


0311 


0312 


0313 


0314 


0315 


0316 


0317 


0318 


0319 


14x 


0320 


0321 


0322 


0323 


0324 


0325 


0326 


0327 


0328 


0329 


0330 


0331 


0332 


0333 


0334 


0335 


15x 


0336 


0337 


0338 


0339 


0340 


0341 


0342 


0343 


0344 


0345 


0346 


0347 


0348 


0349 


0350 


0351 


16x 


0352 


0353 


0354 


0355 


0356 


0357 


0358 


0359 


0360 


0361 


0362 


0363 


0364 


0365 


0366 


0367 


17x 


0368 


0369 


0370 


0371 


0372 


0373 


0374 


0375 


0376 


0377 


0378 


0379 


0380 


0381 


0382 


0383 


18x 


0384 


0385 


0386 


03 87 


0388 


0389 


0390 


0391 


0392 


0393 


0394 


0395 


0396 


0397 


0398 


0399 


19x 


0400 


0401 


0402 


0403 


0404 


0405 


0406 


0407 


0408 


0409 


0410 


0411 


0412 


0413 


0414 


0415 


lAx 


0416 


0417 


0418 


0419 


0420 


0421 


0422 


0423 


0424 


0425 


0426 


0427 


0428 


0429 


0430 


0431 


iBx 


0432 


0433 


0434 


0435 


0436 


0437 


0438 


0439 


0440 


0441 


0442 


0443 


0444 


0445 


0446 


0447 


ICx 


0448 


0449 


0450 


0451 


0452 


0453 


0454 


0455 


0456 


0457 


0458 


0459 


0460 


0461 


0462 


0463 


IDx 


0464 


0465 


0466 


04 67 


0468 


0469 


0470 


0471 


0472 


0473 


0474 


0475 


0476 


0477 


0478 


0479 


lEx 


0480 


0481 


0482 


0483 


0484 


0485 


0486 


0487 


0488 


0489 


0490 


0491 


0492 


0493 


0494 


0495 


IFx 


0496 


0497 


0498 


04 99 


0500 


0501 


0502 


0503 


0504 


0505 


0506 


0507 


0508 


0509 


0510 


0511 


20x 


0512 


0513 


0514 


0515 


0516 


0517 


0518 


0519 


0520 


0521 


0522 


0523 


0524 


0525 


0526 


0527 


21x 


0528 


0529 


0530 


0531 


0532 


0533 


0534 


0535 


0536 


0537 


0538 


0539 


0540 


0541 


0542 


0543 


22x 


0544 


0545 


0546 


0547 


0548 


0549 


0550 


0551 


0552 


0553 


0554 


0555 


0556 


0557 


0558 


0559 


23x 


0560 


0561 


0562 


0563 


0564 


0565 


0566 


0567 


0568 


0569 


0570 


0571 


0572 


0573 


0574 


0575 


24X 


0576 


0577 


0578 


0579 


0580 


0581 


0582 


0583 


0584 


0585 


0586 


0587 


0588 


0589 


0590 


0591 


25x 


0592 


0593 


0594 


0595 


0596 


0597 


0598 


0599 


0600 


0601 


0602 


0603 


0604 


0605 


0606 


0607 


26x 


0608 


0609 


0610 


0611 


0612 


0613 


0614 


0615 


0616 


0617 


0618 


0619 


0620 


0621 


0622 


0623 


27x 


0624 


0625 


0626 


0627 


0628 


0629 


0630 


0631 


0632 


0633 


0634 


0635 


0636 


0637 


0638 


0639 


28x 


0640 


0641 


0642 


0643 


0644 


0645 


0646 


0647 


0648 


0649 


0650 


0651 


0652 


0653 


0654 


0655 


29x 


0656 


0657 


0658 


0659 


0660 


0661 


0662 


0663 


0664 


0665 


0666 


0667 


0668 


0669 


0670 


0671 


2Ax 


0672 


0673 


0674 


0675 


0676 


0677 


0678 


0679 


0680 


0681 


0682 


0683 


0684 


0685 


0686 


0687 


2Bx 


0688 


0689 


0690 


0691 


0692 


0693 


0694 


0695 


0696 


0697 


0698 


0699 


0700 


0701 


0702 


0703 


2Cx 


0704 


0705 


0706 


0707 


0708 


0709 


0710 


0711 


0712 


0713 


0714 


0715 


0716 


0717 


0718 


0719 


2Dx 


0720 


0721 


0722 


0723 


0724 


0725 


0726 


0727 


0728 


0729 


0730 


0731 


0732 


0733 


0734 


0735 


2Ex 


0736 


0737 


0738 


0739 


0740 


0741 


0742 


0743 


0744 


0745 


0746 


0747 


0748 


0749 


0750 


0751 


2Fx 


0752 


0753 


0754 


0755 


0756 


0757 


0758 


0759 


0760 


0761 


0762 


0763 


0764 


0765 


0766 


0767 


30x 


0768 


0769 


0770 


0771 


0772 


0773 


0774 


0775 


0V76 


0777 


0778 


0779 


0780 


0781 


0782 


0783 


31x 


0784 


0785 


0786 


0787 


0788 


0789 


0790 


0791 


0792 


0793 


0794 


0795 


0796 


0797 


0798 


0799 


32x 


0800 


0801 


0802 


0803 


0804 


0805 


0806 


0807 


0808 


0809 


0810 


0811 


0812 


0813 


0814 


0815 


33x 


0816 


0817 


0818 


0819 


0820 


0821 


0822 


0823 


0824 


0825 


0826 


0827 


0828 


0829 


0830 


0831 


3Ux 


0832 


0833 


0834 


0835 


0836 


0837 


0838 


083 9 


0840 


0841 


0842 


0843 


0844 


0845 


0846 


0847 


35x 


0848 


0849 


0850 


0851 


0852 


0853 


0854 


0855 


0856 


0857 


0858 


0859 


0860 


0861 


0862 


0863 


36x 


0864 


0865 


0866 


0867 


0868 


0869 


0870 


0871 


0872 


0873 


0874 


0875 


0876 


0877 


0878 


0879 


37x 


0880 


0881 


0882 


08 83 


0884 


0885 


0886 


0887 


0888 


0889 


0890 


0891 


0892 


0893 


0894 


0895 


38x 


0896 


0897 


0898 


0899 


0900 


0901 


0902 


0903 


0904 


0905 


0906 


0907 


0908 


0909 


0910 


0911 


39x 


0912 


0913 


0914 


0915 


0916 


0917 


0918 


0919 


0920 


0921 


0922 


0923 


0924 


0925 


0926 


0927 


3Ax 


0928 


0929 


0930 


0931 


0932 


0933 


0934 


0935 


0936 


0937 


0938 


0939 


0940 


0941 


0942 


0943 


3Bx 


0944 


0945 


0946 


0947 


0948 


0949 


0950 


0951 


0952 


0953 


0954 


0955 


0956 


0957 


0958 


0959 


3Cx 


0960 


0961 


0962 


0963 


0964 


0965 


0966 


0967 


0968 


0969 


0970 


0971 


0972 


0973 


0974 


0975 


3Dx 


0976 


0977 


0978 


0979 


0980 


0981 


0982 


0983 


0984 


0985 


0986 


0987 


0988 


0989 


0990 


0991 


3Ex 


0992 


0993 


0994 


09 95 


0996 


0997 


0998 


0999 


1000 


1001 


1002 


1003 


1004 


1005 


1006 


1007 


3FX 


1008 


1009 


1010 


1011 


1012 


1013 


1014 


1015 


1016 


1017 


1018 


1019 


1020 


1021 


1022 


1023 



loa 



40x 
41x 
42X 
43x 

ttx 

asx 

46x 
47x 

48x 
49x 
itAx 
KBX 

i»Cx 
UDx 
4 Ex 
UFx 



50x 
51x 
52x 
53x 






1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


102U 


1025 


1026 


1027 


1028 


1029 


1030 


1031 


1032 


1033 


1034 


1035 


1036 


1937 


1G3« 


1039 


1040 


1041 


1042 


1043 


1044 


1045 


1046 


1047 


1048 


1049 


1050 


1051 


1052 


1053 


1054 


1055 


1056 


1057 


1058 


1059 


1060 


1061 


1062 


1063 


1064 


1065 


1066 


1067 


1068 


1069 


1070 


1071 


1072 


1073 


1074 


1075 


1076 


1077 


1078 


1079 


1080 


1081 


1082 


1083 


1084 


1085 


1086 


1087 


1088 


1089 


1090 


1091 


1092 


1093 


1094 


1095 


1096 


1097 


1098 


1099 


1100 


1101 


1102 


1103 


no** 


1105 


1106 


1107 


1108 


1109 


1110 


1111 


1112 


1113 


1114 


1115 


1116 


ni7 


1118 


1119 


1120 


1121 


1122 


1123 


1124 


1125 


1126 


1127 


1128 


1129 


1130 


1131 


1132 


1133 


1134 


1135 


1136 


1137 


1138 


1139 


1140 


114 1 


1142 


1143 


1144 


1145 


1146 


1147 


1148 


1149 


1150 


1151 


1152 


1153 


1154 


1155 


1156 


1157 


1158 


1159 


1160 


1161 


1162 


1163 


1164 


1165 


1166 


1167 


1168 


1169 


1170 


1171 


1172 


1173 


1174 


1175 


1176 


1177 


1178 


1179 


1180 


1181 


1182 


1183 


118a 


1185 


1186 


1187 


1188 


1189 


1190 


1191 


1192 


1193 


1194 


1195 


1196 


1197 


1198 


1199 


1200 


1201 


1202 


1203 


1204 


1205 


1206 


1207 


1208 


1209 


1210 


1211 


1212 


1213 


1214 


1215 


1216 


1217 


1218 


1219 


1220 


1221 


1222 


1223 


1224 


1225 


1226 


1227 


1228 


1229 


1230 


1231 


1232 


1233 


1234 


1235 


1236 


1237 


1238 


1239 


1240 


1241 


1242 


1243 


1244 


1245 


1246 


1247 


12a8 


1249 


1250 


1251 


1252 


1253 


1254 


1255 


1256 


1257 


1258 


1259 


1260 


1261 


1262 


1263 


1264 


1265 


1266 


1267 


1268 


1269 


1270 


1271 


1272 


1273 


1274 


1275 


1276 


1277 


1278 


1279 


1280 


1281 


1282 


1283 


1284 


1285 


1286 


1287 


1288 


1289 


1290 


1291 


1292 


1293 


'^294 


1295 


1296 


1297 


1298 


1299 


1300 


1301 


1302 


1303 


1304 


1305 


1306 


1307 


1308 


1309 


1310 


1311 


1312 


1313 


1314 


1315 


1316 


1317 


1318 


1319 


1320 


1321 


1322 


1323 


1324 


1325 


1326 


1327 


1328 


1329 


1330 


1331 


1332 


1333 


1334 


1335 


1336 


1337 


1338 


1339 


1340 


1341 


1342 


1343 



SUx 1344 1345 1346 1347 1348 1349 

55x 1360 1361 1362 1363 1364 1365 

56x 1376 1377 1378 1379 1380 1381 

57x 1392 1393 1394 1395 1396 1397 

58x 1'»08 1409 1410 1411 1412 1413 

59x 1424 1425 1426 1427 1428 1429 

5Ax 1't'tO 1441 1442 1443 1444 1445 

5Bx 1'»56 1457 1458 1459 1460 1461 

5Cx 1'»72 1473 1474 1475 1476 1477 

5Dx 1'»88 1489 1490 1491 1492 1493 

5Ex 1504 1505 1506 1507 1508 1509 

5Fx 1520 1521 1522 1523 1524 1525 



60x 
Six 
62x 
63x 

sax 

65x 
66x 
67x 

68x 
69x 
6Ax 
6Bx 

6Cx 
6Dx 
6Ex 
6Fx 



70x 
71x 
72x 
73x 

74x 
75x 
76x 
77x 

78x 
79x 
7Ax 
7Bx 

7Cx 
7Dx 
7Ex 
7Fx 



1350 


1351 


1352 


1353 


1354 


1355 


1356 


1357 


1358 


1359 


1366 


1367 


1368 


1369 


1370 


1371 


1372 


1373 


1374 


1375 


1382 


1383 


1384 


1385 


1386 


1387 


1388 


1389 


1390 


1391 


1398 


1399 


1400 


1401 


1402 


1403 


1404 


1405 


1406 


1407 


1414 


1415 


1416 


1417 


1418 


1419 


1420 


1421 


1422 


1423 


1430 


1431 


1432 


1433 


1434 


1435 


1436 


1437 


1438 


1439 


1446 


1447 


1448 


1449 


1450 


1451 


1452 


1453 


1454 


1455 


1462 


1463 


1464 


1465 


1466 


1467 


1468 


1469 


1470 


1471 


1478 


1479 


1480 


1481 


1482 


1483 


1484 


1485 


1486 


1487 


1494 


1495 


1496 


1497 


1498 


1499 


1500 


1501 


1502 


1503 


1510 


1511 


1512 


1513 


1514 


1515 


1516 


1517 


1518 


1519 


1526 


1527 


1528 


1529 


1530 


1531 


1532 


1533 


1534 


1535 



1536 


1537 


1538 


1539 


1540 


1541 


1542 


154 3 


1544 


1545 


1546 


1547 


1548 


1549 


1550 


1551 


1552 


1553 


1554 


1555 


1556 


1557 


1558 


1559 


1560 


1561 


1562 


1563 


1564 


1565 


1566 


1567 


1568 


1569 


1570 


1571 


1572 


1573 


1574 


1575 


1576 


1577 


1578 


1579 


1580 


1581 


1582 


1583 


1584 


1585 


1586 


1587 


1588 


1589 


1590 


1591 


1592 


1593 


1594 


1595 


1596 


1597 


1598 


1599 


1600 


1601 


1602 


1603 


1604 


1605 


1606 


1607 


1608 


1609 


1610 


1611 


1612 


1613 


1614 


1615 


1616 


1617 


1618 


1619 


1620 


1621 


1622 


1623 


1624 


1625 


1626 


1627 


1628 


1629 


1630 


1631 


1632 


1633 


1634 


1635 


1636 


1637 


1638 


1639 


1640 


1641 


1642 


1643 


1644 


1645 


1646 


1647 


1648 


1649 


1650 


1651 


1652 


1653 


1654 


1655 


1656 


1657 


1658 


1659 


1660 


1661 


1662 


1663 


1664 


1665 


1666 


1667 


1668 


1669 


1670 


1671 


1672 


1673 


1674 


167S 


1676 


1677 


1678 


1679 


1680 


1681 


1682 


1683 


1684 


1685 


1686 


1687 


1688 


1689 


1690 


1691 


1692 


1693 


1694 


1695 


1696 


1697 


1698 


1699 


1700 


17011 


1702 


1703 


1704 


1705 


1706 


1707 


1708 


1709 


1710 


1711 


1712 


1713 


1714 


1715 


1716 


1717 


1718 


1719 


1720 


1721 


1722 


1723 


1724 


1725 


1726 


1727 


1728 


1729 


1730 


1731 


1732 


1733 


1734 


1735 


1736 


1737 


1738 


1739 


1740 


1741 


1742 


1743 


1744 


1745 


1746 


1747 


1748 


174 9 


1750 


1751 


1752 


1753 


1754 


1755 


1756 


1757 


1758 


1759 


1760 


1761 


1762 


1763 


1764 


1765 


1766 


1767 


1768 


1769 


1770 


1771 


1772 


1773 


1774 


1775 


1776 


1777 


1778 


1779 


1780 


1781 


1782 


1783 


1784 


1785 


1786 


1787 


1788 


1789 


1790 


1791 


1792 


1793 


1794 


1795 


1796 


1797 


1798 


1799 


1800 


1801 


1802 


1803 


1804 


1805 


1806 


1807 


1808 


1809 


1810 


1811 


1812 


1813 


1814 


1815 


1816 


1817 


1818 


1819 


1820 


1821 


1822 


1823 


1824 


1825 


1826 


1827 


1828 


1829 


1830 


1831 


1832 


1833 


1834 


1835 


1836 


1837 


1838 


1839 


1840 


1841 


1842 


1843 


1844 


1845 


1846 


1847 


1848 


1849 


1850 


1851 


1852 


1853 


1854 


1855 


1856 


1857 


1858 


1859 


1860 


1861 


1862 


1863 


1864 


1865 


1866 


1867 


1868 


1869 


1870 


1871 


1872 


1873 


1874 


1875 


1876 


1877 


1878 


1879 


1880 


1881 


1882 


1883 


1884 


1885 


18B6 


1887 


1888 


1889 


1890 


1891 


1892 


1893 


1894 


1895 


1896 


1897 


1898 


1899 


1900 


1901 


1902 


1903 


1904 


1905 


1906 


1907 


1908 


1909 


1910 


1911 


1912 


1913 


1914 


1915 


1916 


1917 


1918 


1919 


1920 


1921 


1922 


1923 


1924 


1925 


1926 


1927 


1928 


1929 


1930 


1931 


1932 


1933 


1934 


1935 


1936 


1937 


1938 


1939 


1940 


1941 


1942 


1943 


1944 


1945 


1946 


1947 


1948 


1949 


1950 


1951 


1952 


1953 


1954 


1955 


1956 


1957 


1958 


1959 


1960 


1961 


1962 


1963 


1964 


1965 


1966 


1967 


1968 


1969 


1970 


1971 


1972 


1973 


1974 


1975 


1976 


1977 


1978 


1979 


1980 


1981 


1982 


1983 


1984 


1985 


1986 


1987 


1988 


1989 


1990 


1991 


1992 


1993 


1994 


1995 


1996 


1997 


1998 


1999 


2000 


2001 


2002 


2003 


2004 


2005 


2006 


2007 


2008 


2009 


2010 


2011 


2012 


2013 


2014 


2015 


2016 


2017 


2018 


2019 


2020 


2021 


2022 


2023 


2024 


2025 


2026 


2027 


2028 


2029 


2030 


2031 


2032 


2033 


2034 


2035 


2036 


2037 


2038 


2039 


2040 


2041 


2042 


2043 


2044 


2045 


2046 


2047 



Appendix B 105 





X = 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


80x 
81x 
82x 
83x 


2048 
2064 
2080 
2096 


2049 
2065 
2081 
2097 


2050 
2066 
2082 
2098 


2051 
2067 
2083 
2099 


2052 
2068 
2084 
2100 


2053 
2069 
2085 
2101 


2054 
2070 
2086 
2102 


2055 
2071 
2087 
2103 


2056 
2072 
2088 
2104 


2057 
2073 
2089 
2105 


2058 
2074 
2090 
2106 


2059 
2075 
2091 
2107 


2060 
2076 
2092 
2108 


2061 
2077 
2093 
2109 


2062 
2078 
2094 
2110 


2063 
2079 
2095 
2111 


eux 

85x 
86x 
87x 


2112 
2128 
2144 
2160 


2113 
2129 
2145 
2161 


2114 
2130 
2146 
2162 


2115 
2131 
2147 
2163 


2116 
2132 
2148 
2164 


2117 
2133 
2149 
2165 


2118 
2134 
2150 
2166 


2119 
2135 
2151 
2167 


2120 
2136 
2152 
2168 


2121 
2137 
2153 
2169 


2122 
2138 
2154 
2170 


2123 
2139 
2155 
2171 


2124 
2140 
2156 
2172 


2125 
2141 
2157 
2173 


2126 
2142 
2158 
2174 


2127 
2143 
2159 
2175 


88x 
89x 
8Ax 
8Bx 


2176 
2192 
2208 
2224 


2177 
2193 
2209 
2225 


2178 
2194 
2210 
2226 


2179 
2195 
2211 
2227 


2180 
2196 
2212 
2228 


2181 
2197 
2213 
2229 


2182 
2198 
2214 
2230 


2183 
2199 
2215 
2231 


2184 
2200 
2216 
2232 


2185 
2201 
2217 
2233 


2186 
2202 
2218 
2234 


2187 
2203 
2219 
2235 


2188 
2204 
2220 
2236 


2189 
2205 
2221 
2237 


2190 
2206 
2222 
2238 


2191 
2207 
2223 
2239 


8Cx 
8Dx 
8Ex 
8Fx 


2240 
2256 
2272 
2288 


2241 
2257 
2273 
2289 


2242 
2258 
2274 
2290 


2243 
2259 
2275 
22 91 


2244 
2260 
2276 
2292 


2245 
2261 
2277 
2293 


2246 
2262 
2278 
2294 


2247 
2263 
2279 
2295 


2248 
2264 
2280 
2296 


2249 
2265 
2281 
2297 


2250 
2266 
2282 
2298 


2251 
2267 
2283 
2299 


2252 
2268 
2284 
2300 


2253 
2269 
2285 
2301 


2254 
2270 
2286 
2302 


2255 
2271 
2287 
2303 


90x 
91x 
92x 
93x 


2304 
2320 
2336 
2352 


2305 
2321 
2337 
2353 


2306 
2322 
2338 
2354 


2307 
2323 
2339 
2355 


2308 
2324 
2340 
2356 


2309 
2325 
2341 
2357 


2310 
2326 
2342 
2358 


2311 
2327 
2343 
2359 


2312 
2328 
2344 
2360 


2313 
2329 
2345 
2361 


2314 
2330 
2346 
2362 


2315 
2331 
2347 
2363 


2316 
2332 
2348 
2364 


2317 
2333 
2349 
2365 


2318 
2334 
2350 
2366 


2319 
2335 
2351 
2367 


94X 
95x 
96x 
97x 


2368 
2384 
2400 
2416 


2369 
2385 
2401 
2417 


2370 
2386 
2402 
2418 


2371 

2387 
2403 
2419 


2372 

2388 
2404 
2420 


2373 
2389 
2405 
2421 


2374 
2390 
2406 
2422 


2375 
2391 
2407 
2423 


2376 
2392 
2408 
2424 


2377 
2393 
2409 
2425 


2378 
2394 
2410 
2426 


2379 
2395 
2411 
2427 


2380 
2396 
2412 
2428 


2381 
2397 
2413 
2429 


2382 
2398 
2414 
2430 


2383 
2399 
2415 
2431 


98x 
99x 
9Ax 
9Bx 


2432 
2448 
2464 
2480 


2433 
2449 
2465 
2481 


2434 
2450 
2466 
2482 


2435 
2451 
2467 
2483 


2436 
2452 
2468 
2484 


2437 
2453 
2469 
2485 


2438 
2454 
2470 
2486 


2439 
2455 
2471 
2487 


2440 
2456 
2472 
2488 


2441 
2457 
2473 
24 89 


2442 
2458 
2474 
2490 


2443 
2459 
2475 
2491 


2444 
2460 
2476 
2492 


2445 
2461 
2477 
2493 


2446 
2462 
2478 
2494 


2447 
2463 
2479 
2495 


9Cx 
9Dx 
9Ex 
9Fx 


2496 
2512 
2528 
2544 


2497 
2513 
2529 
2545 


2498 
2514 
2530 
2546 


2499 
2515 
2531 
2547 


2500 
2516 
2532 
2548 


2501 
2517 
2533 
2549 


2502 
2518 
2534 
2550 


2503 
2519 
2535 
2551 


2504 
2520 
2536 
2552 


2505 
2521 
2537 
2553 


2506 
2522 
2538 
2554 


2507 
2523 
2539 
2555 


2508 
2524 
2540 
2556 


2509 
2525 
2541 
2557 


2510 
2526 
2542 
2558 


2511 
2527 
2543 
2559 


AOx 
Alx 
A2x 
A3x 


2560 
2576 
2592 
2608 


2561 
2577 
2593 
2609 


2562 
2578 
2594 
2610 


2563 
2579 
2595 
2611 


2564 
2580 
2596 
2612 


2565 
2581 
2597 
2613 


2566 
2582 
2598 
2614 


2567 
2583 
2599 
261 5 


2568 
2584 
2600 
2616 


2569 
2585 
2601 
2617 


2570 
2586 
2602 
2618 


2571 
2587 
2603 
2619 


2572 
2588 
2604 
2620 


2573 
2589 
2605 
2621 


2574 
2590 
2606 
2622 


2575 
2591 
2607 
2623 


A4x 
A5x 
A6x 
A7x 


2624 
2640 
2656 
2672 


2625 
2641 
2657 
2673 


2626 
2642 
2658 
2674 


2627 
2643 
2659 
2675 


2628 
2644 
2660 
2676 


2629 
2645 
2661 
2677 


2630 
2646 
2662 
2678 


2631 
2647 
2663 
2679 


2632 
2648 
2664 
2680 


2633 
2649 
2665 
2681 


2634 
2650 
2666 
2682 


2635 
2651 
2667 
2683 


2636 
2652 
2668 
2684 


2637 
2653 
2669 
2685 


2638 
2654 
2670 
2686 


2639 
2655 
2671 
2687 


A8x 
A9x 
AAx 
ABx 


2688 
2704 
2720 
2736 


2689 
2705 
2721 
2737 


2690 
2706 
2722 
2738 


2691 
2707 
2723 
2739 


2692 
2708 
2724 
2740 


2693 
2709 
2725 
2741 


2694 
2710 
2726 
2742 


2695 
2711 
2727 

2743 


2696 
2712 
2728 

2744 


2697 
2713 
2729 
2745 


2698 
2714 
2730 
2746 


2699 
2715 
2731 
2747 


2700 
2716 
2732 
2748 


2701 
2717 
2733 
2749 


2702 
2718 
2734 
2750 


2703 
2719 
2735 
2751 


ACx 

ADx 
AEx 
AFx 


2752 
2768 
2784 
2800 


2753 
2769 
2785 
2801 


2754 
2770 
2786 
2802 


2755 
2771 
2787 
2803 


2756 
2772 
2788 
2804 


2757 
2773 
2789 
2805 


2758 
2774 
2790 
2806 


2759 
2775 
2791 
2807 


2760 
2776 
2792 
2808 


2761 
2777 
2793 
2809 


2762 
2778 
2794 
2810 


2763 
2779 
2795 
2811 


2764 
2780 
2796 
2812 


2765 
2781 
2797 
2813 


2766 
2782 
2798 
2814 


2767 
2783 
2799 
2815 


BOX 
Blx 
B2x 
B3x 


2816 
2832 
2848 
2864 


28l7 
2833 
2849 
2865 


2818 
2834 
2850 
2866 


2819 
2835 
2851 
2867 


2820 
2836 
2852 
2868 


2821 
2837 
2853 
2869 


2822 
2838 
2854 
2870 


282 3 
2839 
2855 
2871 


2824 
2840 
2856 
2872 


2825 
2841 
2857 
2873 


2826 
2842 
2858 
2874 


2827 
2843 
2859 
2875 


2828 
2844 
2860 
2876 


2829 
2845 
2861 
2877 


2830 
2846 
2862 
2878 


2831 
2847 
2863 
2679 


Bax 
B5x 
B6x 
B7x 


2880 
2896 
2912 
2928 


2881 
2897 
2913 
2929 


2882 
2898 
2914 
2930 


2883 
2899 
2915 
2931 


2884 
2900 
2916 
2932 


2885 
2901 
2917 
2933 


2886 
2902 
2918 
2934 


2887 
2903 
2919 
2935 


2888 
2904 
2920 
2936 


2889 
2905 
2921 
2937 


2890 
2906 
2922 
2938 


2891 
2907 
2923 
2939 


2892 
2908 
2924 
2940 


2893 
2909 
2925 
2941 


2894 
2910 
2926 
2942 


2895 
2911 
2927 
2943 


B8x 
B9x 
BAx 
BBx 


2944 
2960 
2976 
2992 


2945 
2961 
2977 
2993 


2946 
2962 
2978 
2994 


2947 
2963 
2979 
2995 


2948 
2964 
2980 
2996 


2949 
2965 
2981 
2997 


2950 
2966 
2982 
2998 


2951 
2967 
2983 
2999 


2952 
2968 
2984 
3000 


2953 
2969 
2985 
3001 


2954 
2970 
2986 
3002 


2955 
2971 
2987 
3003 


2956 
2972 
2988 
3004 


2957 
2973 
2989 
3005 


2958 
2974 
2990 
3006 


2959 
2975 
2991 
3007 


BCx 

BDx 
BEx 
BFx 


3008 
3024 
3040 
3056 


3009 
3025 
3041 
3057 


3010 
3026 
3042 
3058 


3011 
3027 
3043 
3059 


3012 
3028 
3044 
3060 


3013 
3029 
3045 
3061 


30T4 
3030 
3046 
3062 


3015 
3031 
304 7 
3063 


3016 
3032 
3048 
3064 


3017 
3033 
3049 
3065 


3018 
3034 
3050 
3066 


3019 
3035 
3051 
3067 


3020 
3036 
3052 
3068 


3021 
3037 
3053 
3069 


3022 
3038 
3054 
3070 


3023 
3039 
3055 
3071 
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X = 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


£ 


F 


COx 


3072 


3073 


3074 


3075 


3076 


3077 


3078 


3079 


3080 


3081 


3082 


3083 


3084 


j}ot)5 


3086 


3087 


Clx 


3088 


3089 


3090 


3091 


3092 


3093 


3094 


3095 


3096 


3097 


3098 


3099 


3100 


3101 


3102 


3103 


C2x 


310U 


3105 


3106 


3107 


3108 


3109 


3110 


3111 


3112 


3113 


3114 


3115 


3116 


3117 


3118 


3119 


C3x 


3120 


3121 


3122 


3123 


3124 


3125 


3126 


3127 


3128 


3129 


3130 


3131 


3132 


3133 


3134 


3135 


cax 


3136 


3137 


3138 


3139 


3140 


3141 


3142 


3143 


3144 


3145 


3146 


3147 


3148 


3149 


3150 


3151 


C5x 


T152 


3153 


3154 


3155 


3156 


3157 


3158 


3159 


3160 


3161 


3162 


3163 


3164 


3165 


3166 


3167 


C6x 


3168 


3169 


3170 


3171 


3172 


3173 


3174 


3175 


3176 


3177 


3178 


3179 


3180 


3181 


3182 


3183 


C7x 


3181* 


3185 


3186 


3187 


3188 


3189 


3190 


3191 


3192 


3193 


3194 


3195 


3196 


3197 


3198 


3199 


C8x 


3200 


3201 


3202 


3203 


3204 


3205 


3206 


3207 


3208 


3209 


3210 


3211 


3212 


3213 


3214 


3215 


C9x 


3216 


3217 


3218 


3219 


3220 


3221 


3222 


3223 


3224 


3225 


3226 


3227 


3228 


3229 


3230 


3231 


CAx 


3232 


3233 


3234 


3235 


3236 


3237 


3238 


3239 


3240 


3241 


3242 


3243 


3244 


3245 


3246 


3247 


CBx 


3248 


3249 


3250 


3251 


3252 


3253 


3254 


3255 


3256 


3257 


3258 


3259 


3260 


3261 


3262 


3263 


CCx 


3264 


3265 


3266 


3267 


3268 


3269 


3270 


3271 


3272 


3273 


3274 


3275 


3276 


3277 


3278 


3279 


CDx 


3280 


3281 


3282 


3283 


3284 


3285 


3286 


3287 


3288 


3289 


3290 


32S1 


3292 


3293 


3294 


3295 


CEx 


3296 


3297 


3298 


3299 


3300 


3301 


3302 


3303 


3304 


3305 


3306 


3307 


3308 


3309 


3310 


3311 


CFx 


3312 


3313 


3314 


3315 


3316 


3317 


3318 


3319 


3320 


3321 


3322 


3323 


3324 


3325 


3326 


3327 


DOx 


3328 


3329 


3330 


3331 


3332 


3333 


3334 


3335 


3336 


3337 


3338 


3339 


3340 


3341 


3342 


3343 


Dix 


3344 


3345 


3346 


3347 


3348 


3349 


3350 


3351 


3352 


3353 


3354 


3355 


3356 


3357 


3358 


3359 


D2x 


3360 


3361 


3362 


3363 


3364 


3365 


3366 


3367 


3368 


3369 


3370 


3371 


3372 


3373 


3374 


3375 


D3x 


3376 


3377 


3378 


3379 


3380 


3381 


3382 


3383 


3384 


3385 


3386 


3387 


3388 


3389 


3390 


3391 


DUx 


3392 


3393 


3394 


3395 


3396 


3397 


3398 


3399 


3400 


3401 


3402 


3403 


3404 


3405 


3406 


3407 


D5x 


3408 


3409 


3410 


3411 


3412 


3413 


3414 


3415 


3416 


3417 


3418 


3419 


3420 


3421 


3422 


3423 


D6x 


3424 


3425 


3426 


3427 


3428 


3429 


3430 


3431 


3432 


3433 


3434 


3435 


3436 


3437 


3438 


3439 


D7x 


3440 


3441 


3442 


3443 


3444 


3445 


3446 


3447 


3448 


3449 


3450 


3451 


3452 


3453 


3454 


3455 


D8x 


3456 


3457 


3458 


3459 


3460 


3461 


3462 


3463 


3464 


3465 


3466 


3467 


3468 


3469 


3470 


3471 


D9x 


3472 


3473 


3474 


3475 


3476 


3477 


3478 


3479 


3480 


3481 


3482 


3483 


3484 


3485 


3486 


3487 


DAx 


3488 


3489 


3490 


3491 


3492 


3493 


3494 


3495 


3496 


3497 


3498 


3499 


3500 


3501 


3502 


3503 


DBx 


3504 


3505 


3506 


3507 


3508 


3509 


3510 


3511 


3512 


3513 


3514 


3515 


3516 


3517 


3518 


3519 


DCx 


3520 


3521 


3522 


3523 


3524 


3525 


3526 


3527 


3528 


3529 


3530 


3531 


3532 


3533 


3534 


3535 


DDx 


3536 


3537 


3538 


3539 


3540 


3541 


3542 


3543 


3544 


3545 


3546 


3547 


3548 


3549 


3550 


3551 


DEx 


3552 


3553 


3554 


3555 


3556 


3557 


3558 


3559 


3560 


3561 


3562 


3563 


3564 


3565 


3566 


3567 


DFx 


3568 


3569 


3570 


3571 


3572 


3573 


3574 


3575 


3576 


3577 


3578 


3579 


3580 


3581 


3582 


3583 


EOx 


3584 


3585 


3586 


3587 


3588 


3589 


3590 


3591 


3592 


3593 


3594 


3595 


3596 


3597 


3598 


3599 


Elx 


3600 


3601 


3602 


3603 


3604 


3605 


3606 


3607 


3608 


3609 


3610 


3611 


3612 


3613 


3614 


3615 


E2x 


3616 


3617 


3618 


3619 


3620 


36211 


3622 


3623 


3624 


3625 


3626 


3627 


3628 


3629 


3630 


3631 


E3x 


3632 


3633 


3634 


3635 


3636 


3637 


3638 


3639 


3640 


3641 


3642 


3643 


3644 


3645 


3646 


3647 


E4x 


3648 


3649 


3650 


3651 


3652 


3653 


3654 


3655 


3656 


3657 


3658 


3659 


3660 


3661 


3662 


3663 


E5x 


3664 


3665 


3666 


3667 


3668 


3669 


3670 


3671 


3672 


3673 


3674 


3675 


3676 


3677 


3678 


3679 


E6x 


3680 


3681 


3682 


36 83 


3684 


3685 


3686 


3687 


3688 


3689 


3690 


3691 


3692 


3693 


3694 


3695 


E7x 


3696 


3697 


3698 


3699 


3700 


37011 


3702 


3703 


3704 


3705 


3706 


3707 


3708 


370"^' 


37 10 


3711 


E8x 


3712 


3713 


3714 


3715 


3716 


3717 


3718 


3719 


3720 


3721 


3722 


3723 


3724 


3725 


3726 


3727 


E9x 


3728 


3729 


3730 


3731 


3732 


3733 


373 4 


3735 


3736 


3737 


3738 


3739 


3740 


3741 


3742 


3743 


EAx 


3744 


3745 


3746 


3747 


3748 


3749 


3750 


3751 


3752 


3753 


3754 


3755 


3756 


3757 


3758 


3759 


EBx 


3760 


3761 


3762 


3763 


3764 


3765 


3766 


3767 


3768 


3769 


3770 


3771 


3772 


3773 


3774 


3775 


ECx 


3776 


3777 


3778 


3779 


3780 


3781 


3782 


3783 


3784 


3785 


3786 


3787 


3788 


3789 


3790 


3791 


EDx 


3792 


3793 


3794 


3795 


3796 


3797 


3798 


3799 


3800 


3801 


3802 


3803 


3804 


3805 


3806 


3807 


EEx 


3808 


3809 


3810 


3811 


3812 


3813 


3814 


3815 


3816 


3817 


3818 


3819 


3820 


3821 


3822 


3823 


EFx 


3824 


3825 


3826 


3827 


3828 


3829 


3830 


3831 


3832 


3833 


3834 


3835 


3836 


3837 


3838 


3839 


fOx 


3840 


3841 


3842 


3843 


3844 


384 5 


3846 


3847 


3848 


3849 


3850 


3851 


3352 


3853 


3854 


3 855 


Fix 


3856 


3857 


3858 


3859 


3860 


3861 


3862 


3863 


3864 


3865 


3866 


3867 


3868 


3869 


3870 


3871 


F2x 


3872 


3873 


3874 


3875 


3876 


3877 


3878 


3879 


3880 


3881 


3882 


3883 


3884 


3885 


3886 


3887 


F3x 


3888 


3889 


3890 


3891 


3892 


3893 


3894 


3895 


3896 


3897 


3898 


3899 


3900 


3901 


3902 


3903 


FUx 


3904 


3905 


3906 


3907 


3908 


3909 


3910 


3911 


3912 


3913 


3914 


3915 


3916 


3917 


3918 


3919 


F5x 


3920 


3921 


3922 


3923 


3924 


3925 


3926 


3927 


3928 


3929 


3930 


3931 


3932 


3933 


3934 


3935 


F6x 


3936 


3937 


3938 


3939 


3940 


3941 


3942 


3943 


3944 


3945 


3946 


3947 


3948 


3949 


3950 


3951 


F7x 


3952 


3953 


3954 


3955 


3956 


3957 


3958 


3959 


3960 


3961 


3962 


3963 


3964 


3965 


3966 


3967 


F8x 


3968 


3969 


3970 


3971 


3972 


3973 


3974 


3975 


3976 


3977 


3978 


3979 


3980 


3981 


3982 


3983 


F9x 


3984 


3985 


3986 


3987 


3988 


3989 


3990 


3991 


3992 


3993 


3994 


3995 


3996 


3997 


3998 


3999 


FAX 


4000 


4001 


4002 


4003 


4004 


4005 


4006 


4007 


4008 


4009 


4010 


4011 


4012 


4013 


4014 


4015 


FBx 


4016 


4017 


4018 


4019 


4020 


4021 


4022 


4023 


4024 


4025 


4026 


4027 


4028 


4029 


4030 


4031 


FCx 


4032 


4033 


4034 


4035 


4036 


4037 


4038 


4039 


4040 


4041 


4042 


4043 


4044 


4045 


4046 


4047 


FDx 


4048 


4049 


4050 


4051 


4052 


4053 


4054 


4055 


4056 


4057 


4058 


4059 


4060 


4061 


4062 


4063 


FEx 


4064 


4065 


4066 


4067 


4068 


4069 


4070 


4071 


4072 


4073 


4074 


4075 


4076 


4077 


4078 


4079 


FFx 


4080 


4081 


4082 


4083 


4084 


4085 


4086 


4087 


4088 


4089 


4090 


4091 


4092 


4093 


4094 


4095 
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APPENDIX C: MACHINE- INSTRUCTION FORMAT 





BASIC MACHINE FORMAT 

1 T — T — ^ 

1 8 \^ {^i \ 
1 Operation) j | 
1 Code 1R1|R2| 

L X X J 





"T- 


ASSEMBLER OPERAND 
FIELD FORMAT 

R1,R2 


-T 

1 APPLICABLE INSTRUCTIONS 
.| 

lAll RR instructions 
! except SPM and SVC 


-1 

-4 


|RR| 


1 8 l** 1 1 
1 Operation! | | 
1 code |R1| 1 

1 X X J 






Rl 


ISPM 




1— -h 


1 T 1 

1 8 1 8 1 
1 Operation! ! 
! Code 1 I 1 

L_ X _ J 




-+■ 


1 

1 
1 

I isvc 
(See Notes 1, 6, 8, and 9) 


-4 


|RX| 


1 T — T — r — r — 1 

1 8 !t» |i» |4 |12! 
! Operation! 1 1 I 1 
! code |R1|X2|B2!D2| 

t X J i J J 

r - — T — T--r--T — 1 
1 8 \H \ii !U 1121 
1 Operation! 1 1 I 1 
! Code 1 Rl ! R3 1 B2 1 D2 1 

L X J X X J 





-+- 


R1,D2(X2,B2) 
R1,D2(,B2) 
R1,S2(X2) 
(See notes 1-4, 1, and 9] 

R1,R3,D2(B2) 
R1,R3,S2 


lAll RX instructions 

1 
-^ _ 

1BXH,BXLE,LM,3TM 


-4 


|RS| 














H-+- 


r --T T T T 1 

1 8 - 14 1 lU 1121 
lOperationl 111! 
1 Code IRII 1B21D2! 

L X X X X J 

1 T T T 1 

1 8 ! 8 |4 1121 
lOperationl | | 1 
1 Code 1 12 IBllDll 

t J X J J 




-+- 


R1,D2(B2) 
R1,S2 
(See Notes 1-3,7, and 8) 

D1(B1),I2 
SI, 12 


1 Ail shift instructions 

4 

1 Ail SI instructions 
1 except LPSW,SSM, 
1 HIO, SIO,TIO,TCH,TS 


-4 


|SI| 














1 j , y p J. -, 

1 i 1 8 1 \H 1121 
j 1 1 Operation 1 | | | 
1 1 1 Code 1 IBljDll 

1 1 L i L_ X- J 

|._.^ 

1 1 1 r — T — r — r — r — r — i 

1 t 1 8 |a |4 |4 11214 |12| 
1 1 lOperationl | I i I I | 
1 1 1 Code |L1|L2|B1|D1|B2|D2| 


-f 


DKBl) 
SI 
(See Notes 2, 3, and 6-85 


1 LPSW , SSM,HIO, SIO, 

1TI0,TCH,TS 

1 

.X _ _ 


1 


D1(L1,B1),D2(L2,B2> 
S1(L1),S2(L2) 


T — — 

1 PACK , UNPK , MVO , AP , 
!CP,DP,MP,SP,ZAP 


"1 


|SS| 
















^ ^ y -y. ^_ T--^ 

1 8 18 14 112|U 112| 
lOperationl 1 1 1 1 1 
! Code 1 L 1B11D11B21D2I 
L X L L L L J 




D1(L,B1),D2(B2) 
S1(L),S2 
(See Notes 2,3,5, and 7) 


|NC,OC,XC,CLC,MVC,MVN, 
1 MVZ, TR, TRT,ED , EDMK 
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Notes for Appendix C : 

1. Rl, R2, and R3 are absolute expressions that specify general or floating-point reg- 
isters. The general register numbers are through 15; floating-point register num- 
bers are 0, 2, U, and 6. 

2. Dl and D2 are absolute expressions that specify displacements. A value of - 4095 
may be specified. 

3. Bl and B2 are absolute expressions that specify base registers. Register numbers are 
- 15. 

4. X2 is an absolute expression that specifies an index register. Register numbers are 
0-15. 

5. L, LI, and L2 are absolute expressions that specify field lengths. An L expression 
can specify a value of 1 - 256. LI and L2 expressions can specify a value of 1 - 16. 
In all cases, the assembled value will be one less than the specified value. 

6. I and 12 are absolute expressions that provide immediate data. The value of the 
expression may be - 255. 

7. SI and S2 are absolute or relocatable expressions that specify an address. 

8. RR, RS, and SI instruction fields that are blank under BASIC MACHINE FORMAT are not 
examined during instruction execution- The fields are not written in the symbolic 
operand, but are assembled as binary zeros, 

9. Rl specifies a 1-bit mask in the BC and BCR machine instructions. 
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APPENDIX D: MACHINE- INSTRUCTION MNEMONIC OPERATION CODES 



This appendix contains a table of the mnemonic operation codes for 
all machine instructions that can be represented in assembler 
language, including extended mnemonic operation codes. It is in 
alphabetic order by instruction. Indicated for each instruction ore 
both the mnemonic and machine operation codes, explicit and 
implicit operand formats, program interruptions possible, and condition 
code set. 

The column headings in this appendix and the information each 
column provides follow. 



Instruction: This column contains the name of the instruction 
associated with the mnemonic operation code. 



Mnemonic Operation Code: This column gives the mnemonic 
operation code for the machine instruction. This is written in the 
operation field when coding the instruction. 



Machine Operation Code: This column contains the hexadecimal 
equivalent of the actual machine operation code. The operation code 
will appear in this form in most storage dumps and when displayed on 
the system control panel . For extended mnemonics, this column also 
contains the mnemonic code of the instruction from which the extended 
mnemonic is derived. 



Operand Format: This column shows the symbolic format of the 
operand field in both explicit and implicit form. For both forms, 
R] , R2, and R3 indicate general registers in operands one, two, and 
three respectively. X2 indicates a general register used as an index 
register in the second operand. Instructions which require an index 
register (X2) but are not to be indexed are shown with a replacing 
X2 . L, LI, and L2 indicate lengths for either operand, operand one, 
and operand two respectively . 

For the explicit format, D1 and D2 indicate a displacement and 
Bl and B2 indicate a base register for operands one and two. 

For the implicit format, D1,B1 and D2,B2 are replaced by SI 
and S2 which indicate a storage address in operands one and two. 

Type of Instruction: This column gives the basic machine format of 

the instruction (RR, RX, SI, or SS). If an instruction is included 

in a special feature or is an extended mnemonic, this is also indicated. 

Program Interruptio ns Possible: This column indicates the possible 
program interruptions for this instruction. The abbreviations used are: 
A - Addressing, S - Specification, Ov - Overflow, P - Protection, 
Op - Operation (if feature is not installed) and Other - other 
interruptions which are listed. The type of overflow is indicated by: 
D - Decimal, E - Exponent, or F- Floating Point. 

Condition Code Set: The condition codes set as a result of this 
instruction are indicated in this column. (See legend following 
the table). 



Machine-Instruction Operation Codes 
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Instruction 


Mnemonic 


Machine 


Operand Format 1 




Operation 


Operation 








Code 


Code 


Explicit 


Implicit 


Add 


A 


5A 


Rl,D2(X2,B2)orR1, D2(, B2) 


Rl,S2(X2)orRl,S2 


Add 


AR 


lA 


R1,R2 




Add Decimal 


AP 


FA 


D1(L1,B1),D2(L2,B2) 


Sl(Ll),S2(L2)or S1,S2 


Add Halfword 


AH 


4A 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Add Logical 


AL 


5E 


Rl,D2{X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Add Logical 


ALR 


IE 


R1,R2 




Add Normalized, Long 


AD 


6A 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Add Normalized, Long 


ADR 


2A 


R1,R2 




Add Normalized, Short- 


AE 


7k 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Add Normalized, Short 


AER 


3A 


R1,R2 




Add Unnormalized,Long 


AW 


6E 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Add Unnormalized,Long 


AWR 


2E 


R1,R2 




Add Unnormaiized, Short 


AU 


7E 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Add Unnormaiized, Short 


AUR 


3E 


R1,R2 




And Logical 


N 


54 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


And Logical 


NC 


D4 


D1(L,B1),D2(B2) 


S1(L),S2 or S1,S2 


And Logical 


NR 


14 


R1,R2 




And Logical Immediate 


Nl 


94 


D1(B1),|2 


SI, 12 


Branch and Link 


BAL 


45 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Branch and Link 


BALR 


05 


R1,R2 




Branch on Condition 


BC 


47 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Branch on Condition 


BCR 


07 


R1,R2 




Branch on Count 


BCT 


46 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Branch on Count 


BCTR 


06 


R1,R2 




Branch on Equal 


BE 


47(BC 8) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on High 


BH 


47(BC 2) 


D2(X2, B2)or D2(, B2) 


S2(X2) or S2 


Branch on Index High 


BXH 


86 


R1,R3,D2(B2) 


R1,R3,S2 


Branch on Index Low or Equal 


BXLE 


87 


R1,R3,D2(B2) 


R1,R3,S2 


Branch on Low 


BL 


47(BC 4) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch if Mixed 


BM 


47(BC 4) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Minus 


BM 


47(BC 4) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Not Equal 


BNE 


47(BC 7) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Not High 


BNH 


47(BC 13) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Not Low 


BNL 


47(BC 11) 


D2(X2,B2)or D2(,B2 ) 


S2(X2) or S2 


Branch on Not Minus 


BNM 


47(BC 11) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Not Ones 


BNO 


47(BC 14) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Not Plus 


BNP 


47(BC 13) 


D2(X2,B2)or D2(,B2) 


S2(X2 or S2 


Branch on Not Zeros 


BNZ 


47(BC 7) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch if Ones 


BO 


47(BC 1) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Overflow 


BO 


47(BC 1) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Plus 


BP 


47(BC 2) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch if Zeros 


BZ 


47(BC 8) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch on Zero 


BZ 


47(BC 8) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch Unconditional 


B 


47(BC 15) 


D2(X2,B2)or D2(,B2) 


S2(X2) or S2 


Branch Unconditional 


BR 


07(BCR 15) 


R2 




Compare Algebraic 


C 


59 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2 or R1,S2 


Compare Algebraic 


CR 


19 


R1,R2 




Compare Decimal 


CP 


F9 


D1(L1,B1),D2(L2,B2) 


Sl(Ll),S2(L2)or S1,S2 


Compare Halfword 


CH 


49 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Compare Logical 


CL 


55 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Compare Logical 


CLC 


D5 


D1(L,B1),D2(B2) 


S1(L),S2 or S1,S2 


Compare Logical 


CLR 


15 


R1,R2 




Compare Logical Immediate 


CLI 


95 


D1(B1),I2 


SI, 12 


Compare, Long 


CD 


69 


Rl,D2(X2,B2)orR1,D2(,B2) 


Rl,S2(X2)or R1,S2 


Compare, Long 


CDR 


29 


R1,R2 




Compare, Short 


CE 


79 


Rl,D2(X2,B2)or R1,D2(,B2) 


Rl,S2(X2)or Rl , S2 


Compare, Short 


CER 


39 


R1,R2 




Convert to Binary 


CVB 


4F 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)or R1,S2 


Convert to Decimal 


CVD 


4E 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 
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Program Interruption 










Instruction 


Type of 
Instruction 


Possible 




Condit 


on Code Set 




A 


S 


Ov 


P 


Op 


other 


00 


01 


10 


11 


Add 


RX 


x 


X 


F 








Sum=0 


Sum<0 


Sum>0 


Overflow 


Add 


RR 






F 








Sum=0 


Sum<0 


Sum>0 


Overflow 


Add Decimal 


SS, Decimal 


X 




D 


X 


X 


Data 


Sum=0 


Sum<0 


Sum>0 


Overflow 


Add Halfword 


RX 


X 


X 


F 








Sum=0 


Sum<0 


Sum>0 


Overflow 


Add Logical 


RX 


X 


X 










Sum=0(B) 


Sum 0(H) 


Sum= 0® 


Sum ® 


Add Logical 


RR 














Sum=0(3) 


Sum= 0@ 


Sum= 0® 


Sum 0® 


Add Normalized, Long 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 




M 


P 


Add Normalized, Long 


RR, Floating Pt , 




X 


E 




X 


B,C 


R 




M 


P 


Add Normalized, Short- 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 




M 


P 


Add Normalized, Short 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 




M 


P 


Add UnnormalizedjLong 


RX, Floating Pt. 


X 


X 


E 




X 


C 


R 




M 


P 


Add Unnormalized, Long 


RR, Floating Pt. 




X 


E 




X 


C 


R 




M 


P 


Add Unnormalized, Short 


RX, Floating Pt. 


X 


X 


E 




X 


C 


R 




M 


P 


Add Unnormalized, Short 


RR, Floating Pt. 




X 


E 




X 


C 


R 




M 


P 


Add Logical 


RX 


X 


X 










J 


K 






And Logical 


SS 


X 






X 






J 


K 






And Logical 


RR 














J 


K 






And Logical Immediate 


SI 


X 






X 






J 


K 






Branch and Link 


RX 














N 


N 


N 


N 


Branch and Link 


RR 














N 


N 


N 


N 


Branch on Condition 


RX 














N 


N 


N 


N 


Branch on Condition 


RR 














N 


N 


N 


N 


Branch on Count 


RX 














N 


N 


N 


N 


Branch on Count 


RR 














N 


N 


N 


N 


Branch on Equal 


RX , Ext. Mnemoni c 














N 


N 


N 


N 


Branch on High 


RXfExt.Mnemonic 














N 


N 


N 


N 


Branch on Index High 


RX,Ext.Mnemonic 














N 


N 


N 


N 


Branch on Index Low or Equal 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Low 


RX,Ext Jvlnemonic 














N 


N 


N 


N 


Branch if Mixed 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Minus 


RX,Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Equal 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not High 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Low 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Minus 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Ones 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Plus 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Zeros 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Ones 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Overflow 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Plus 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch if Zeros 


RX,Ext.Mnemonic 














N 


N 


N 


N 


Branch on Zero 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch Unconditional 


RX, Ext.Mnemonic 














N 


N 


N 


N 


Branch Unconditional 


RR, Ext.Mnemonic 














N 


N 


N 


N 


Compare Algebraic 


RX 


X 


X 










Z 


AA 


BB 




Compare Algebraic 


RR 














Z 


AA 


BB 




Compare Decimal 


SS, Decimal 


X 








X 


Data 


z 


AA 


BB 




Compare Halfword 


RX 


X 


X 










z 


AA 


BB 




Compare Logical 


RX 


X 


X 










z 


AA 


BB 




Compare Logical 


RX 


X 


X 










z 


AA 


BB 




Compare Logical 


SS 


X 












z 


AA 


BB 




Compare Logical Immediate 


SI 


X 












z 


AA 


BB 




Compare, Long 


RX, Floating Pt. 


X 


X 






X 




z 


AA 


BB 




Compare, Long 


RR, Floating Pt. 


X 


X 






X 




z 


AA 


BB 




Compare, Short 


RX, Floating Pt. 


X 


X 






X 




z 


AA 


BB 




Compare, Short 


RR, Floating Pt. 




X 






X 




z 


AA 


BB 




Convert to Binary 


RX 


X 


X 








Data,F 


N 


N 


N 


N 


Convert to Dec imai 


RX 


X 


X 




X 






N 


N 


N 


N 



Condition Code Set (Add) 
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InslTuction 


Mnemonic 


Machine 


Operand Format 






Operation 


Operation 










Code 


Code 


Explicit 


Implic' 


i 


Divide 


D 


5D 


R],D2(X2,B2)orRl,D2(,B2) 


Rl, S2(X2) 


or R1,S2 


Divide 


DR 


ID 


R1,R2 






Divide Decimal 


DP 


FD 


D1,(L1,B1),D2(L2,B2) 


Sl(Ll),S2(L2)or S1,S2 | 


Divide, Long 


DD 


6D 


Rl,D2(X2,B2),or R1,D2(,B2) 


R1,S2(X2) 


or Rl , S2 


Divide, Long 


DDR 


2D 


R1,R2 






Divide, Short 


DE 


7D 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Divide, Short 


DER 


3D 


R1,R2 






Edit 


ED 


DE 


D1(L,B1),D2(B2) 


S1(L),S2 


or S1,S2 


Edit and Mark 


EDMK 


DF 


D1(L,B1),D2(B2) 


S1(L),S2 


or S1,S2 


Exclusive Or 


X 


57 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Exclusive Or 


XC 


D7 


D1(L,B1),D2(B2) 


S1(L),S2 


or SI , S2 


Exclusive Or 


XR 


17 


R1,R2 






Exclusive Or Immediate 


XI 


97 


D1(B1),12 


51,12 




Execute 


EX 


44 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


R1,S2 


Halve, Long 


HDR 


24 


R1,R2 






Halve, Short 


HER 


34 


R1,R2 






Halt I/O 


HIO 


9E 


Dl(Bl) 






Insert Character 


IC 


43 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Insert Storage Key 


ISK 


09 


R1,R2 






Load 


L 


58 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Load 


LR 


18 


R1,R2 






Load Address 


LA 


41 


Rl,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Load and Test 


LTR 


12 


R1,R2 






Load and Test, Long 


LTDR 


22 


R1,R2 






Load and Test, Short 


LTER 


32 


R1,R2 






Load Complement 


LCR 


13 


R1,R2 






Load Complement, Long 


LCDR 


23 


R1,R2 






Load Complement, Short 


LCER 


33 


R1,R2 






Load Halfword 


LH 


48 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Load, Long 


LD 


68 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Load, Long 


LDR 


28 


R1,R2 






Load Multiple 


LM 


98 


R1,R3,D2(B2) 


R1,R3,S2 




Load Negative 


LNR 


n 


R1,R2 






Load Negative, Long 


LNDR 


21 


R1,R2 






Load Negative, Short 


LNER 


31 


R1,R2 






Load Positive 


LPR 


10 


R1,R2 






Load Positive, Long 


LPDR 


20 


R1,R2 






Load Positive, Short 


LPER 


30 


R1,R2 






Load PSW 


LPSW 


82 


Dl(Bl) 






Load, Short 


LE 


78 


R1,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Load, Short 


LER 


38 


R1,R2 






Move Characters 


MVC 


D2 


D1(L,B1),D2(B2) 


S1(L),S2 


or S1,S2 


Move Immediate 


MVI 


92 


Dl(Bl), 12 


SI, 12 




Move Numerics 


MVN 


Dl 


D1(L,B1),D2(B2) 


S1(L),S2 


or S1,S2 


Move with Offset 


MVO 


F1 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2)or S1,S2 


Move Zones 


MVZ 


D3 


D1(L,B1),D2(B2) 


S1(L),S2 


or S1,S2 


Multiply 


M 


5C 


Rl,D2(X2,B2)orRT,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Multiply 


MR 


TC 


R1,R2 






Multiply Decimal 


MP 


FC 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2 


or S1,S2 


Mulitply Halfword 


MH 


4C 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Multiply, Long 


MD 


6C 


Rl,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Multiply, Long 


MDR 


2C 


R1,R2 






Multiply, Short 


ME 


7C 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


orR1,S2 


Multiply, Short 


MER 


3C 


R1,R2 






No Operation 


NOP 


47(BC 0) 


D2(X2,B2)or D2(,B2) 


S2(X2) 


or S2 



Operand Format (Divide) 
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Instruction 


Type of 
Instruction 


Program Interrupt 
Possible 


ions 




Conditi 


on Code Set 






A 


S 


Ov 


P 


Op 


Other 


00 


01 


10 


11 


Divide 


RX 


X 


X 








F 


N 


N 


N 


N 


Divide 


RR 




X 








F 


N 


N 


N 


N 


Divide Decimal 


SS, Decimal 


X 


X 




X 


X 


D, Data 


n" 


N 


N 


N 


Divide, Long 


RX,Floating Pt. 


x 


X 


E 




X 


B,E 


N 


N 


N 


N 


Divide, Long 


RR, Floating Pt. 




X 


E 




X 


B,E 


n 


N 


N 


N 


Divide, Short 


RX, Floating Pt. 


X 


X 


E 




X 


B,E 


n 


N 


N 


N 


Divide, Short 


RR, Floating Pt. 




X 


E 




X 


B,E 


N 


N 


N 


N 


Edit 


SS, Decimal 


X 






X 


X 


Data 


S 


T 


U 




Edit and Mark 


SS, Decimal 


X 






X 


X 


Data 


S 


T 


U 




Exclusive Or 


RX 


X 


X 










J 


K 






Exclusive Or 


SS 


X 






X 






J 


K 






Exclusive Or 


RR 














J 


K 






Exclusive Or Immediate 


SI 


X 






X 






J 


K 






Execute 


RX 


X 


X 








G 


(May be 


set by this instruction) 




Halve, Long 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 


Halve, Short 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 


Halt I/O 


SI 












A 


DD 


CC 


GG 


KK 


Insert Character 


RX 


X 












N 


N 


N 


N 


Insert Storage Key 


RR 


X 


X 






X 


A 


N 


N 


N 


N 


Load 


RX 


X 


X 










N 


N 


N 


N 


Load 


RR 














N 


N 


N 


N 


Load Address 


RX 














N 


N 


N 


N 


Load and Test 


RR 














J 


L 


M 




Load and Test, Long 


RR, Floating Pt. 




X 






X 




R 


L 


M 




Load and Test, Short 


RR, Floating Pt. 




X 






X 




R 


L 


M 




Load Complement 


RR 






F 








P 


L 


M 


O 


Load Complement, Long 


RR, Floating Pt. 




X 






X 




R 


L 


M 




Load Complement, Short 


RR, Floating Pt. 




X 






X 




R 


L 


M 




Load Halfword 


RX 


X 


X 










N 


N 


N 


N 


Load, Long 


RX, Floating Pt. 


X 


X 






X 




N 


N 


N 


N 


Load, Long 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 


Load Multiple 


RS 


X 


X 










N 


N 


N 


N 


Load Negative 


RR 














J 


L 






Load Negative, Long 


RR, Floating Pt. 




X 






X 




R 


L 






Load Negative, Short 


RR, Floating Pt. 




X 






X 




R 


L 






Load Positive 


RR 






F 








J 




M 


O 


Load Positive, Long 


RR, Floating Pt. 




X 






X 




R 


L 


M 




Load Positive, Short 


RR, Floating Pt. 




X 






X 




R 


L 


M 




Load PSW 


SI 


X 


X 








A 


QQ 


QQ 


QQ 


QQ 


Load, Short 


RX, Floating Pt. 


X 


X 






X 




N 


N 


N 


N 


Load, Short 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 


Move Characters 


SS 


X 






X 






N 


N 


N 


N 


Move Immediate 


51 


X 






X 






N 


N 


N 


N 


Move Numerics 


SS 


X 






X 






N 


N 


N 


N 


Move with Offset 


SS 


X 






X 






N 


N 


N 


N 


Move Zones 


SS 


X 






X 






N 


N 


N 


N 


Multiply 


RX 


X 


X 










N 


N 


N 


N 


Multiply 


RR 




X 










N 


N 


N 


N 


Multiply Decimal 


SS, Decimal 


X 


X 




X 


X 


Data 


N 


N 


N 


N 


Multiply Halfword 


RX 


X 


X 










N 


N 


N 


N 


Multiply, Long 


RX, Floating Pt. 


X 


X 


E 




X 


B 


N 


N 


N 


N 


Multiply, Long 


RR, Floating Pt. 




X 


E 




X 


B 


N 


N 


N 


N 


Multiply, Short 


RX, Floating Pt. 


X 


X 


E 




X 


B 


N 


N 


N 


N 


Multiply, Short 


RR, Floating Pt. 




X 


E 




X 


B 


N 


N 


N 


N 


No Operation 


RX,ExtJv\nemonic 














N 


N 


N 


N 



Condition Code Set (Divide) 
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Instruction 


Mnemonic 


Machine 


Operand Format 






Operation 


Operation 










Code 


Code 


Explicit 


Implicit 




No Operation 


NOPR 


07(BCR 0) 


R2 






Or Logical 


O 


56 


Rl,D2{X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


orRl,S2 


Or Logical 


OC 


D6 


D1(L,B1),D2(B2) 


S1(L),S2 


or S1,S2 


Or Logical 


OR 


16 


R1,R2 






Or Logical Immediate 


Ol 


96 


D1(B1),I2 


SI, 12 




Pack 


PACK 


F2 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2 


or S1,S2 


Read Direct 


RDD 


85 


D1(B1),|2 


SI, 12 




Set Program Mask 


SPM 


04 


R1 






Set System Key 


SSK 


08 


R1,R2 






Set System Mask 


SSM 


80 


Dl(Bl) 


SI 




Shift Left Double Algebraic 


SLDA 


8F 


R1,D2(B2) 


R1,S2 




Shift Left Double Logical 


SLDL 


8D 


R1,D2(B2) 


R1,S2 




Shift Left Single Algebraic 


SLA 


8B 


R1,D2(B2) 


R1,S2 




Shift Left Single Logical 


SLL 


89 


R1,D2(B2) 


R1,S2 




Shift Right Double Algebraic 


SRDA 


8E 


R1,D2(B2) 


R1,S2 




Shift Right Double Logical 


SRDL 


8C 


R1,D2(B2) 


R1,S2 




Shift Right Single Algebraic 


SRA 


8A 


R1,D2(B2) 


R1,S2 




Shift Right Single Logical 


SRL 


88 


R1,D2(B2) 


R1,S2 




Start I/O 


SiO 


9C 


Dl(Bl) 


SI 




Store 


ST 


50 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Store Character 


STC 


42 


Rl,D2(X2,B2)or R1,D2(,B2 


R1,D2(X2) 


or R1,S2 


Store Halfword 


STH 


40 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


orRl,S2 


Store Long 


STD 


60 


R1,D2(X2,B2) 


R1,S2(X2) 


or R1,S2 


Store Multiple 


STM 


90 


R1,R2,D2(B2) 


R1,R2,S2 




Store Short 


STE 


70 


R1,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract 


S 


5B 


R1,D2(X2 


R1,S2(X2) 


or Rl , S2 


Subtract 


SR 


IB 


R1,R2 






Subtract Decimal 


SP 


FB 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2 


or S1,S2 


Subtract Halfword 


SH 


4B 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract Logical 


SI 


5F 


Rl,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract Logical 


SLR 


IF 


R1,R2 






Subtract Normalized, Long 


SD 


6B 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract Normalized, Long 


SDR 


2B 


R1,R2 






Subtract Normalized, Short 


SE 


7B 


Rl,D2(X2,B2)or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract Normalized, 


SER 


3B 


R1,R2 






Subtract Unnormalized, Long 


SW 


6F 


Rl , D2(X2, B2) or R1,D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract Unnormalized, Long 


SWR 


2F 


R1,R2 






Subtract Unnormalized, Short 


SU 


7F 


Rl,D2(X2,B2)or Rl, D2(,B2) 


R1,S2(X2) 


or R1,S2 


Subtract Unnormalized, Short 


SUR 


3F 


R1,R2 






Supervisor Call 


SVC 


OA 


1 






Test and Set 


TS 


93 


Dl(Bl) 


SI 




Test Channel 


TCH 


9F 


Dl(Bl) 


SI 




Test I/O 


TiO 


9D 


Dl(Bl) 


SI 




Test Under Mask 


TM 


91 


D1(B1),12 


SI, 12 




Translate 


TR 


DC 


D1(L,B1),D2{B2) 


S1(L),S2 


orSl , S2 


Translate and Test 


TRT 


DD 


D1(L,B1),D2(B2) 


S1(L),S2 


orSl , S2 


Unpack 


UNPK 


F3 


D1{L1,B1), D2(L2,B2) 


Sl(Ll),S2(L2)or S1,S2 


Write Direct 


WRD 


84 


D1(B1),|2 


SI, 12 




Zero and Add Decimal 


ZAP 


F8 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2 


)or S1,S2 



Operand Format (No Operation) 
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Type of 
Instruction 


Program Interrupt' 


ons 










Instruction 


Possible 








Condition Code Set 






A 


s 


Ov 


P 


Op 


Other 


00 


01 


10 


11 


No Operation 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Or Logical 


RX 


X 


X 










J 


K 






Or Logical 


SS 


X 






X 






J 


K 






Or Logical 


RR 














J 


K 






Or Logical Immediate 


SI 


X 






X 






J 


K 






Pack 


SS 


X 






X 






N 


N 


N 


N 


Read Direct 


SI 


X 






X 


X 


A 


N 


N 


N 


N 


Set Program Mask 


RR 














RR 


RR 


RR 


RR 


Set Storage Key 


RR 


X 


X 






X 


A 


N 


N 


N 


N 


Set System Mask 


SI 


X 










A 


N 


N 


N 


N 


Shift Left Double Algebraic 


RS 




X 


F 








J 


L 


M 


O 


Shift Left Double Logical 


RS 




X 










N 


N 


N 


N 


Shift Left Single Algebraic 


RS 






F 








J 


L 


M 


O 


Shift Left Single Logical 


RS 














N 


N 


N 


N 


Shift Right Double Algebraic 


RS 




X 










J 


L 


M 




Shift Right Double Logical 


RS 




X 










N 


N 


N 


N 


Shift Right Single Algebraic 


RS 














J 


L 


M 




Shift Right Single Logical 


RS 














N 


N 


N 


N 


Start I/O 


SI 












A 


MM 


CC 


EE 


AA 


Store 


RX 


X 


X 




X 






N 


N 


N 


N 


Store Character 


RX 


X 






X 






N 


N 


N 


N 


Store Halfword 


RX 


X 


X 




X 






N 


N 


N 


N 


Store Long 


RX, Floating Pt. 


X 


X 




X 


X 




N 


N 


N 


N 


Store Multiple 


RS 


X 


X 




X 






N 


N 


N 


N 


Store Short 


RX, Floating Pt. 


X 


X 




X 


X 




N 


N 


N 


N 


Subtract 


RX 


X 


X 


F 








V 


X 


Y 


O 


Subtract 


RR 






F 








V 


X 


Y 


O 


Subtract Decimal 


SS, Decimal 


X 




D 


X 


X 


Data 


V 


X 


Y 


O 


Subtract Halfword 


RX 


X 


X 


F 








V 


X 


Y 


O 


Subtract Logical 


RX 


X 


X 












W,H 


V,l 


W,l 


Subtract Logical 


RR 
















W,H 


V,l 


W,l 


Subtract Normalized, Long 


RX, Floating Pt . 


X 


X 


E 




X 


B,C 


R 




M 


Q 


Subtract Normalized, Long 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 




M 


Q 


Subtract Normalized, Short 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 




M 


Q 


Subtract Normalized, Short 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 




M 


Q 


Subtract Unnormalized, Long 


RX, Floating Pt. 


X 


X 


E 




X 


C 


R 




M 


Q 


Subtract Unnormalized, Long 


RR, Floating Pt. 




X 


E 




X 


C 


R 




M 


Q 


Subtract Unnormalized, Short 


RX, Floating Pt. 


X 


X 


E 




X 


C 


R 




M 


Q 


Subtract Unnormalized, Short 


RR, Floating Pt. 




X 


E 




X 


C 


R 




M 


Q 


Supervisor Call 


RR 














N 


N 


N 


N 


Test and Set 


SI 


X 






X 






ss 


TT 






Test Channel 


Si 












A 


JJ 


II 


FF 


HH 


Test I/O 


SI 












A 


LL 


CC 


EE 


KK 


Test Under Mask 


Si 


X 












UU 


VV 




WW 


Translate 


SS 


X 






X 






N 


N 


N 


N 


Translate and Test 


SS 


X 












PP 


NN 


OO 




Unpack 


SS 


X 






X 






N 


N 


N 


N 


Write Direct 


SI 


X 








X 


A 


N 


N 


N 


N 


Zero and Add Decimal 


SS, Decimal 


X 




D 


X 


X 


Data 


J 


L 


M 


O 



Condition Code Set (No Operation) 
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Program 


nterruptions Possible 


Under 


Ov: D = Decimal 




E = Exponent 




F = Fixed Point 


Under 


Other: 




A Privileged Operation 




B Exponent Underflow 




C Significance 




D Decimal Divide 




E Floating Point Divide 




F Fixed Point Divide 




G Execute 


Condition Code Set 


H 


No Carry 


1 


Carry 


J 


Result = 


K 


Result is Not Equal to Zero 


L 


Result is Less Than Zero 


M 


Result is Greater Than Zero 


N 


Not Changed 


O 


Overflow 


P 


Result Exponent Underflows 


Q 


Result Exponent Overflows 


R 


Result Fraction = 


S 


Result Field Equals Zero 


T 


Result Field is Less Than Zero 


U 


Result Field is Greater Than Zero 


V 


Difference = 


w 


Difference is Not Equal to Zero 


X 


Difference is Less Than Zero 


Y 


Difference is Greater Than Zero 


Z 


First Operand Equals Second Operand 


AA 


First Operand is Less Than Second Operand 


BB 


First Operand is Greater Than Second Operand 


CC 


CSW Stored 


DD 


Channel and Subchannel not Working 


EE 


Channel or Subchannel Busy 


FF 


Channel Operating in Burst Mode 


GG 


Burst Operation Terminated 


HH 


Channel Not Operational 


II 


Interruption Pending in Channel 


JJ 


Channel Available 


KK 


Not Operational 


LL 


Available 


MM 


l/O Operatiorv Initiated and Channel Proceeding With its Execution 


NN 


Nonzero Function Byte Found Before the First Operand Field is Exhausted 


OO 


Last Function Byte is Nonzero 


PP 


All Function Bytes Are Zero 


QQ 


Set According to Bits 34 and 35 of the New PSW Loaded 


RR 


Set According to Bits 2 and 3 of the Register Specified by R1 


SS 


Leftmost Bit of Byte Specified = 


TT 


Leftmost Bit of Byte Specified = 1 


UU 


Selected Bits Are All Zeros; Mask is All Zeros 


VV 


Selected Bits Are Mixed (xeros and ones) 


WW 


Selected Bits Are All Ones 



Program Interruptions Possible 
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APPENDIX E: ASSEMBLER INSTRUCTIONS 



Operation 
Entry 



ACTR 



AGO 
A IF 



Name Entry 



Not used, must not be present 
A sequence symbol or not present 
A sequence symbol or not present 



Operand Entry 
An arithmetic SETA expression 
A sequence symbol 



H 



A loqical expression enclosed in 
parentheses, immediately followed by a 
sequence symbol 



ANOP 



A sequence symbol 



Not used, must not be present 



CCW 



Any symbol or not present 



Four Ofjerands, separated by commas 



CNOP 



A sequence symbol or not present 



Two absolute expressions, separated by 
a comma | 
^ 

Not used, must not be present 

^ 



COM 



A sequence symbol or not present 



COPY 



Not used, must not be present 



A symbol 



CSECT 



Any symbol or not present 



Not use<l , must not be present 



DC 



Any symbol or not present 



One operand 



DROP 



A sequence symbol or not present 



One to sixteen absolute expressions, 
separated by commas 



DS 



Any symbol or not present 



One operand 



DSECT I A variable symbol or an 
ordinary symbol 



Not used, must not be present 



EJECT 



END 



A sequence symbol or not present 



Not used, must not be present 



A sequence symbol 
or not present 



A relocatable expression 
or not present 



—I 



■H 



ENTRY 



A sequence symbol or not present 



One or more relocatable symbols, sepa- 
rated by commas 



EQU 



A variable symbol or an 
ordinary sym^bol 



An absolute or relocatable expression 



EXTRISI 



A sequence symbol or not present 



One or more relocatable symbols, 3(> pa- 
rated by commas 



GBLA 



Not used, must not be present 



One or more variable symbols that are 
to be used as SET symbols, separated 
by cominas ^ 



GBLB 



Not used, mxist not be present 



One or more variable symbols that are 
to be used as SET symbols, separated 
by commas^ 



GBLC 



Not used, must not be present 



One or more variable symbols that are 
to be used as SET symbols, separated 
by commas 2 
^ 

One to three decimal values, separated | 
by commas | 

J 



ICTL 



Not used, must not be present 
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r T 

Operation 
Entry 

I + 

ISEQ 

LCLA 



Name Entry 
Not used, must not be present 



Not used, must not be present 



^ ^ 

One or more variable symbols that are 
to be used as SET symbols, separated 
by commas^ 



Operand Entry 



Two decinal values, separated by a 
comma 



-^ 



One or more variable symbols that are 
to be used as SET symbols, separated 
by commas^ 



LCLB 



Not used , must not be present 



LCLC 



Not used, must not be present 



One or more variable symbols separated 
by commas^ 



LTORG 



MACROS- 



Any symbol or not present 
Not used, must not be present 



+ 



Not used, must not be present 



Not used, must not be present 



—I 

-H 



MEND^ 



A sequence symbol or not present 



+-- 



Not used, must not be present 



MEXIT^ 



A sequence symbol or not present 



Not used, must not be present 



MNOTEi 



A sequence symbol, a variable 
symbol or not present 



A severity code, followed by a coinir.a, 
followed by any combination of charac- 
ters enclosed in apostrophes 



ORG 



A sequence symbol or not used 



A relocatable expression or not used 



PRI NT 



A sequence symbol or not present 



One to three operands 



PUNCH 



A sequence symbol or not present 



One to eighty characters enclosed in 
apostrophes 



REPRO 



A sequence symbol or not used 



Not used, must not be present 



SETA 
SETB 



A SETA symbol 



An arithmetic expression 



A SETB symbol 



A or a 1, or logical expression 
enclosed in parentheses 



■H 



SETC 



A SETC symbol 



A type attribute, a character expres- 
sion, a substring notation, or a con- 
catenation of character expressions 
and substring notations 



SPACE 



START 



TITLE- 



A sequence symbol or not present 



A decimal self-def ining term or not 
used 



Any symbol or not present 



f-- 



A special symbol (0 to k charac- 
ters), a sequence symbol, a 
variable symbol, or not present 



+-" 



A self-defining term or not used 



-■I 



One to 100 characters, enclosed in 
apostrophes 



USING 



A sequence symbol or not present 



An absolute or relocatable expcession 
followed by 1 to 16 absolute expres- 
sions, separated by commas 



^May only be used as part of a macro-definition. 

^SET symbols may be defined as subscripted SET symbols 

^See Section 5 for the description of the name entry. 
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ASSEMBIiER STATEMENTS 



INSTRUCTION 



NAME ENTRY 



OPERAND ENTRY 



I 

Model statements 3 *♦ 
(A variable syinbol or any 
assembler language mnemonic 
operation code except COPY, 
END, ICTL, ISEQ, and PRINT 



-H 



|. 

Prototype Statement^ 



An ordinary symbol, variable 
symbol, sequence 
symbol, a combination of 
variable symbols and other 
characters that is equivalent 
to a symbol, or not used 



Any combination of char- 
acters (including variable 
symbols) 



— ^ 



A symbolic parameter or 
not used 



Macro-Instruction 
Statement*^ 



An ordinary symbol, a 
variable symbol, a sequence 
syitibolj a combination of 
variable symbols and other 
characters that is equivale 
to a symbol,^ or not used 



Zero or more operands that 
are symbolic parameters, 
separated by commas, followed 
by zero or more operands 
(separated by commas) of the 
form symbolic parameter, 
equal sign, optional standard 
value 

Zero or more positional 
operands separated by commas, 
followed by zero or more 
keyword operands (separated 
ntlby commas) of the form 

keyword, equal sign, value^ 



Assembler Language 
Statement^ ** 



An ordinary symbol, a var- 
iable symbol, a sequence 
symbol, a combination 
of variable symbols and 
other characters that is 
equivalent to a symbol, 
or not used 



Any combination of characters 
(including variable symbols) 



^ May only be used as part of a macro-definition. 

2 Variable symbols appearing in a macro- instruct ion are 
replaced by their valu€;s before the macro-instruction is 
processed, 

3 Variable symbols may not be used to generate the follow- 
ing mnemonic operation codes s ACTR, COPY, END, ICTL, 
CSECT, DSECT, ISEQ, PRINT, REPRO, and START. Variable 
symbols may not be used in the name and operand entries 
of the following instructions: COPY, END, ICTL, and ISEQ. 
Variable symbols may not be used in the name entry of the 
ACTR instruction. 

*♦ The line following a REPRO statement may not contain 
variable symbols. 
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APPENDIX F: SUMMARY OF CONSTANTS 



^ ^ 

LENGTH 
MODI- 
FIER 
RANGE 



T 1 

TRUN- 
CATION/ 
PADDING 
SIDE 

right 



TYPE 






IMPLIED 

LENGTH 

(BYTES) 



as 

needed 



ALIGN- 
MENT 



byte 



1 to 
256 (1) 



SPECIFIED 
BY 



characters 



CON- 
STANTS 

PER 
OPERAND 

one 



RANGE 
FOR EX- 
PONENTS 



RANGE 

FOR 
SCALE 

-I 



as 
needed 

as 
needed 

2 






byte 
byte 
word 



1 to 
256 (1) 



hexadecimal 
digits 



one 






half 
word 



1 to 
256 

1 to 8 
1 to 8 



binary 
digits 



one 






decimal 
digits 






decimal 
digits 



multiple 
multiple 



-85 to 
+75 



-187 to 
+ 3U6 



left 
left 
left 






— ^ 



-85 to 
+ 75 



-187 
+ 3U6 



left 



word 



1 to 8 



decimal 
digits 



multiple 



-8 5 to 
+75 



to la 



right 



H- 



8 

as 

needed 

as 
needed 



double 
word 



1 to 



byte i 1 to 
16 

byte I 1 to 
16 



decimal 
digits 

decimal 
digits 

decimal 

digits 



multiple 
multiple 
multiple 



-85 to 
+75 



to m 












right 

left 

left 



word 



1 to a 



an absolute 
expression 



multiple 



left 






word 



3 or 4 



3 or U 



a relocatable 
or complex 
relocatable 
expression 

relocatable 
symbol 

+■ 



multiple 



+— 



left 



-^ 



half 
word 



2 only 



f 

Y 






half 
word 



1 or 2 



one absolute 
or relocatab- 
le expression 
or two absol- 
ute express- 
ions : 
exp (exf)) 



multiple 



an absolute 
expression 



— f 
multiple 






left 



■-^ 



2 only 



a relocatable 
or compl e x 
relocatable 
expression 



(1) In a DS assembler instruction, C and X type constants may have length specification 
to 65535. 



122 



APPENDIX G: MACRO FACILITY SUMMARY 



The four charts in this appendix summarize 
the macro facility described in Part 2 of 
this publication- 

Chart 1 indicates which macro facility 
elements may be used in the name and oper- 
and entries of each statement. 



Chart 3 is a summary of the attributes 
that may be used in each expression. 



Chart U is a summary of the variable 
symbols that may be used in each expres- 
sion. 



Chart 2 is a summary of the expressions 
that may be used in macro- instruct ion 
statements. 



statement 


Variable Symbols 








Attr 


butes 


Number 


Sequence 
Symbol 


Global SET Symbols 


Lc 


cal SET Symbols 


System Variable Symbols 


Symbolic 
Parameter 


SETA 


SETB 


SETC 


SETA 


SETB 


SETC 


&SYSNDX 


&SYSECT 


&SYSLIST 


Type 


Length 


Scaling 


Integer 


Count 


MACRO 


































- 


Prototype 
Statement 


Name 
Operand 






























GBLA 




Operand 



































GBLB 






Operand 






















GBLC 








Operand 
























LCLA 










Operand 


























LCLB 












Operand 
























LCLC 














Operand 






















Model 
Statement 


Name 

Operation 

Operand 


Nome 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Nome 

Operation 

Operand 


Nome 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Nome 

Operation 

Operand 














Name 


COPY 


































Nome 


SETA 


Operand^ 


Name 
Operand 


Operand^ 


Operand 


Name 
Operand 


Operand 


Operand^ 


Operand 




Operand 




Operand 


Operand 


Operand 


Operand 


Operand 




SETB 


Operand 


Operand^ 


Name 
Operand 


Operand^ 


Operand*^ 


Name 
Operand 


Operand* 


Operand* 


Operand 


Operand^ 


Operand^ 


Operand^ 


Operand^ 


Operand^ 


Operand^ 


Operand^ 




SETC 


Operand 


Operand' 


Operand^ 


Name 
Operand 


Operand 


Operand^ 


Name 
Operand 


Operand 


Operand 


Operand 


Operand 














AIF 


Operand'^ 


Operand* 


O pe rand 


Operand* 


Operand^ 


Operand 


Operand* 


Operand* 


Operand'^ 


Operand*^ 


Operand'^ 


Operand^ 


Operand^ 


Operand^ 


Operand^ 


Operand^ 


Name 
Operand 


AGO 


































Name 
Operand 


ACTR 


Operand^ 


Operand 


Operond^ 


Operand 


Operand 


Operand^ 


Operand^ 


Operand 




Operand^ 




Operand 


Operand 


Operand 


Operand 


Operand 




ANOP 


































Name 


MEXIT 






























r " "" 




Name 


MNOTE 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 














Name 
Name 


MEND 


































Outer 
Macro 




Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 




















Name 


Inner 
Macro 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 














Name 


Assembler 
Language 
Statement 




Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 




















Name 


1 . Variable symbols in macro-instruct 

2. Only if value is self-defining term 

3. Converted to arithmetic +1 or +0. 

4. Only in character relations. 

5. Only in arithmetic relations. 

6. Only in arithmetic or character rel 

7. Converted to unsigned number . 

8. Converted to character i or 0. 

9. Only if one to eight decimal digits 


ons are replaced by tfteir 


values befor 


processing . 

















Chart 1. Macro Facility Elements 
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Chart 2, Expressions 



j Expression j 



Arithmetic Expressions | Character Expressions 



Logical Expressions 



■i 



H- 



May 
contain 



5. 



6. 



Self-defining terms 
Length, scaling, 
integer, count, and 
number attributes 
SETA and SETB symbols 
SETC symbols whose 
value is 1-8 decimal 
digits 

Symbolic parameters 
if the corresponding 
operand is a self- 
defining term 
6SYSLIST(n) if the 
corresponding operand 
is a self-defining 
term 

6SYSLIST(n,m) if the 
corresponding operand 
is a self-defining 
term 
SSYSNDX 



1. Any combination of 
characters enclosed 
in apostrophes 

2. Any variable symbol 
enclosed in apos- 
trophes 

3. A concatenation of 
variable symbols and 
other characters 
enclosed in apos- 
trophes 

U. A request for a type 
attribute. 



1. SETB symbols 

2. Arithmetic re- 
lations^ 

3. Character re- 
lations^ 



Operators 
are 



Range 

of values 



+,-,*, and / 

parentheses permitted 



concatenation , with a 
period (.) 



AND, OR, and NOT 
parentheses per- 
mitted 



-23^ to +23*-l 



through 127 characters 



(false) or 

1 (true) 



1. SETC operands 3 

2. Character relations ^ 

3. SETA operands** 



1. SETB operands 

2. A IF operands 



May be j 1. SETA operands 

used in j 2. Arithmetic relations 

3. subscripted SET 
symbols 

U. 6SYSLIST 

5. Substring notation 

6. Sublist notation 

7. SETC operands 

8. ACTR operands 

An arithmetic relation consists of two arithmetic expressions related by the opera- 
tors GT, LT, EQ, NE, GE, or LE. 

A character relation consists of two character expressions related by the operator 
GT, LT, EQ, NE, GE, or LE. The type attribute notation and the substring notation 
may also be used in character relations. The maximum length of the character 
expressions that can be compared is 127 characters. If the two character expres- 
sions are of unequal length, then the shorter one will always compare less than the 
longer. 

Maximum of eight characters will be assigned. 
If one to eight decimal digits. 
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Chart 3. Attributes 



Attribute 



Notation 



May be used with: 



May be used only if 
type attribute is: 



May be used in 



Type 



T' 



Symbols outside 
macro-definitions; 
symbolic parameters, 
6SYSLIST(n), and 
6SYSLIST(n,m) inside 
macro-definitions 



(May always be used) 



1. SETC operand 
fields 

2. Character 
relations 

(SETB) 



Length 



L« 



Scaling 



S' 



Integer 



!• 



Count 



K' 



Symbols outside 
macro-definitions; 
symbolic parameters, 
6SYSLIST(n), and 
6SYSLIST(n,m) inside 
macro- definitions 



Any letter except 

M,N,0,T, and U 



Arithmetic 
expressions 



Symbols outside 
macro- definitions; 
symbolic parameters, 
SSYSLIST{n), and 
6SYSLIST(n,m) inside 
macro-definitions 



■+ 



H,F,G,D,E,K,P, and Z 



Arithmetic 
expressions 



Symbols outside 
macro-definitions ; 
symbolic parameters, 
SSYSLISTCn) , and 
6SYSLIST(n,m) inside 
macro-definitions 



- + 



H,F,G,D,E,K,P, and Z 



Arithmetic 
expressions 



Symbolic parameters 
corresponding to 
macro-instruction 
operands, 6SYSLIST 
(n) , and SSYSLlST{n,m) 
inside macro- 
definitions 



Any letter 






Arithmetic 
expressions 



Number 



N' 



Symbolic parameters, 
6SYSLIST, and 
6SYSLIST(n) inside 
macro- definitions 



Any letter 



Arithmetic 
expressions 
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Chart U. Variable Symbols 



Variable 
symbol 



Defined by ; 



Initialized, 
or set to: 



-+- 



Value changed 
by: 



May be used in: 



Symbolic^ 
parameter 



Prototype 
statement 



Corresponding 

macro-instruction 

operand 



(Constant 

throughout 

definition) 



1. Arithmetic expressions 
if operand is self- 
defining term 

2. Character expressions 



SETA 



SETB 



LC LA or GBLA 
instruction 



SETA 
instruction 



1. Arithmetic expressions 

2. Character expressions 



LCLB or GBLB 
instruction 



SETB 
instruction 



1. Arithmetic expressions 

2. Character expressions 

3. Logical expressions 



SETC 



LCLC or GBLC 
instruction 



Null character 
va lue 



SETC 
instruction 



1. Arithmetic expressions 
if value is one to 
eight decimal digits 

2. Character expressions 



6SYSNDX^ 



The assembler 



Macro- instruct! on 
index 



(Constant 
throughout 
definition; 
unique for 
each macro- 
instruction) 



1. Arithmetic expressions 

2. Character expressions 



6SYSECT^ 



The assembler 



Control section 
in which macro- 
instruction 
appears 



(Constant 
throughout 
definition; 
set by CSECT, 
DSECT, and 
START) 



Character expressions 



SSYSLIST^- 



The assembler 



Not applicable 



Not applicable 



N'SSYSLIST in arithmetic 
expressions 



6SYSLIST(n)»^ 
6SYSLIST(n,m)i 



The assembler 



Corresponding 
macro- instruct! on 
operand 



(Constant 

throughout 

definition) 



j.__„ 1 1 

I ^ May only be used in macro-definitions, 



-+- 



1. Arithmetic expressions 
if operand is self- 
defining term 

2. Character expressions 



H 
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APPENDIX H: DICTIONARY AND SOURCE STATEMENT SIZES 



PART li DICTIONARIES USED IN MACRO QENE RATION 



A. Dictionaries at Collection Time 



For the Macro Generator portion of the Assembler to accomplish macro generation and 
conditional assembly, two or more dictionaries must be constructed: a Global Dic- 
tionary and one or more Local Dictionaries, 



Global Dictionary 

One Global Dictionary is built for the entire program. It contains macro- instruction 
mnemonics and global SET variable names. The capacity of the Global Dictionary is 64 
blocks of 256 bytes each. An entry is made for each unique macro-instruction mnemon- 
ic and each unique global SET variable name. Each block contains complete entries. 
Any entry not fitting into a block is placed in the next block with the remaining 
bytes in the present block unused. The entries are as follows: 



Macro Mnemonic Operation Code 
Global SET Variable Name 

Fixed Overhead 



10 bytes plus mnemonic* 

6 bytes plus name* (A dimensioned global 
SET variable is counted only once) 

8 bytes for first block 

4 bytes for each succeeding block 

5 bytes for last block 



Local Dictionary 

For the main portion of the pro<gfram, one Local Dictionary is constructed in which 
ordinary symbols (relevant to macro generation and conditional assembly), sequence 
symbols, and local SET variable names are entered. In addition, one Local Dictionary 
is constructed for each different macro definition used in the program. These Local 
Dictionaries contain one entry for each local SET variable name, sequence symbol, and 
prototype symbolic parameter declared within the macro definition. The capacity of 
each Local Dictionary is 64 blocks of 25 6 bytes each. Each block contains complete 
entries. Any entry not fitting into a block is placed in the next block with the 
remaining bytes in the present block unused. The following table indicates the size 
of each type of entry and will serve to relate dictionary capacities to the structure 
of any given program: 



Sequence Symbol Names 
Local SET Variable Names 

Prototype Symbolic Parameters 

Relevant ordinary symbols 
appearing in the main 
portion of the program 

Fixed Overhead 



10 bytes plus name* 

6 bytes plus name* (A dimensioned local 
SET variable is counted only once) 

5 bytes plus name* 

10 bytes plus name* 



8 bytes for first block 

4 bytes for each succeeding block 

5 bytes for last block 



* One byte is used for each character in the name or mnemonic 



B. Dictionaries at Generation Time 
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To conserve storage during the actual conditional assembly and macro generation, the 
contents of the Global Dictionary and Local Dictionaries are restructured as follows: 



Global Dictionary 

Fixed Overhead 

Macro Mnemonic Operation Code 

Global SETA dimensioned 

Global SETA undimensioned 

Global SETB dimensioned 

Global SETB undimensioned 
Global SETC dimensioned 
Global SETC unciimensioned 



^ bytes plus word alignment 

3 bytes 

1 byte plus IN 

^, byt es 

1 byte plus (N/8) 

tN/8 is rounded to the next highest integer] 

1 byte 

1 byte plus 9N 

9 bytes 



Local Dictionary 
Fixed Overhead 
Seguence Symbols 
Local SETA dimensioned 
Local SETA undimensioned 
Local SETB dimensioned 

Local SETB undimensioned 
Local SETC dimensioned 
Local SETC undimensioned 



20 bytes plus word alignment 

5 byt es 

1 byte plus UN 

U bytes 

1 byte plus (N/8) 

(N/8 is rounded to the next highest integer] 

1 byte 

1 byte plus 9N 

9 bytes 



Relevant ordinary symbols appearing in 
the main portion of the program 5 bytes 

N = dimension 



Note: Only those symbols which appear in m=icro instruction operands or whose attri- 
butes are referenced are included in this table. These entries are required only 
for the main program Local Dictionary. 

The restructured Global Dictionary and the restructured Local Dictionary for the 
main portion of the program must be resident in main storage. 

In addition, if the program contains any macro- instruct ions, main storage is 
required for the largest Local Dictionary of the macro-definitions being processed. 
Furtherniore, if any macro-definitions contain inner macro- instructions, main storage 
is required for all the restructured Local Dictionaries of all the macros in the 
nest. 

In addition to those requirements specified above for the Local Dictionary of the main 
portion of the program, each macro-definition Local Dictionary requires the following for 
the parameter table: 



1. Fixed Overhead 

2. Table Entries 



22 bytes 



128 



a. 
b. 



c. 



Character string 
Hexadecimal, binary, 
decimal, and character 
self-defining values 
Symbol 
Sublist 



3 bytes plus L 



7 bytes plus L 

9 bytes plus L 

10 bytes plus 2N bytes plus Y 



L-Length of entry 

N=Number of entries in sublist 

Y=Total length of table entries of a., b. , and c. fornats 

Each nested macro-instruction also requires the following; 
Parameter pointer list 2 bytes plus 2N (N = the number of operands) 

Pointers to list in table 8 bytes plus word alignment 



PART 2: MACRO MNEMONIC TABLE 

As the source text is scanned, a table of macro mnemonics is constructed. There is an 
entry for each macro used or defined as a programmer macro in the program. The entries 
are made under the premise that every undefined operation is a system macro mnemonic. 
This table is then subsetted to locate and edit system macros from the library. 

An entry in this subsetted table consists of 9 bytes. With 10,240 bytes of main stor- 
age available, approximately U50 distinct macro mnemonics can be handled. When this 
table overflows, processing continues with only those macros defined at that point. If 
additional storage is available, this table is expanded accordingly. 



PART 3; SOURCE STATEMENT COMPLEXITY - CONDITIONAL ASSEMBLY AND MACRO GENERATION 

For any statement except macro-prototype or macro instructions, a counter is increased by 
one for each literal occurrence of the following: 

1. Ordinary Symbol 

a. Name, operation, or operand entry (when the operand count starts, the counter 
is decremented by one) , or 

b. Operand of an EXTRN statement, or 

c. Operand of an attribute operator (L',T',I*, etc, in a SETA, SEIB or SETC 
expression, or 

d. Operand of a machine or assembler instruction (only if in the main portion of 
the program) 

2. Variable Symbol 

3. Sequence Symbol 

Note 1 ; The maximum value the counter may attain is 35. 

Note 2 : This restriction applies to the narr« and operation entry of a macro-instruction 
or prototype taken as a unit- Each macro-instruction or prototype operand (in sub- 
list, each sublist operand) is also subject to the counter restriction. 

Examples of counts 

1. SB2 SETB (T'NAME EQ*W' OR ' gC . ' A' EQ'AAM 
count =3 



2. 



EXTRN A, B, C, £C 
count =4 
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PART 4; SOURCE STATEMENT COMPLEXITY; ASSEMBLER STATEMENTS 

With 10,210 bytes of main storage available, statement size,S, must be less than 727 
bytes for DC and DS statements and less than 7U3 bytes for all others- 

For all statements: S = Ngi-Np+i* (Nls+1^SD^*^*^S"^Nl^ 

Where Ng =total number of bytes in name, operation, operand, and comments entries 
(the maximum value of Ng is 187). 

Nq = number of operators and delimiters in the operand entry {except equal (=) , per- 
iod (.), and apostrophe (•)] 

Nls~ number of references to length attribute (L' SYMBOL), 

NgD = number of self-defining terms, 

Ng = number of symbolic terms (including ♦) , 

And N^ = number of literal operands (maximum of 1) 

Example: 

NAME MVC A+(B-C)*3(L»D,5) ,=15CL5*ABCDEFG* 
S=39+9+4(l*4)+6(3-H) 
=92 

In general, all statements can be processed if they contain 50 or fewer terms. If a 
statement contains more than 50 terms, the formula should be used to determine if the 
statement can be processed, or if the statement should be shortened using EQU assembler 
instructions. For example, if A+(B-C)*3 were equated to a symbol, that symbol could be 
used as the displacement field of the first operand in the example. 
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APPENDIX I: SAMPLE PROGRAM 



Given: 

1. A TABLE with 15 entries, each 16 bytes long, having the following format: 

I NUMBER of items | SWITCHes | ADDRESS | NAME ) 

t J J. X J 

3 bytes 1 byte H bytes 8 bytes 

2. A LIST of items, each 16 bytes long, having the following format: 

r -^T T r 1 

I NAME I SWITCHes j NUMBER of items j ADDRESS j 

L X , L . L J 

8 bytes 1 byte 3 bytes 4 bytes 

Find: Any of the items in the LIST which occur in the TABLE and put the SWITCHes, 

NUMBER of items, and ADDRESS from that LIST entry into the corresponding TABLE 
entry. If the LIST item does not occur in the TABLE, turn on the first bit in 
the SWITCHes byte of the LIST entry. 

The TABLE entries have been sorted by their NAME, 

EXAM TITLE 'SAMPLE PROGRAM' 

* THIS IS THE MACRO-DEFINITION 

* 

MACRO 

MOVE &T0,6FR0M 

.+ DEFINE SETC SYMBOL 

LCLC 6TYPE 
. ♦ 

.♦ CHECK NUMBER OF OPERANDS 
.♦ 

AIF (N'SSYSLIST NE 2).ERRORl 
.♦ 

. * CHECK TYPE ATTRIBUTES OF OPERANDS 
.♦ 

AIF (T'STO NE T ' &FROM) ,ERR0R2 

AIF (T' 6T0 EQ *C' OR T'&TO EQ 'G* OR T'6T0 EQ 'K').TYPECGK 

AIF (T'&TO EQ 'D' OR T* 6T0 EQ ' E' OR T* STO EQ *H').TYPEDEH 

AIF (T'STO EQ •F'>.MOVE 

AGO . ERROR3 
.TYPEDEH ANOP 
. ♦ 

.* ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL 
. ♦ 

6TYPE SETC T'STO 
. MOVE ANOP 

* NEXT TWO STATEMENTS GENERATED FOR MOVE MACRO 
L&TYPE 2,£FR0M 

ST6TYPE 2,ST0 

MEXIT 
.* 

. * CHECK LENGTH ATTRIBUTES OF OPERANDS 
.+ 
TYPECGK AIF (L'STO NE L'SFROM OR L'STO GT 256).ERRORU 

* NEXT STATEMENT GENERATED FOR MOVE MACRO 
MVC &TO,&FROM 

MEXIT 

Appendix I 131 



. ♦ 

.ERRORl 
.ERROR2 
. ERR0R3 
. ERR0R4 

BEGIN 



MORE 



ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS 

MNOTE 1,' IMPROPER NUMBER OF OPERANDS, NO STATEMENTS GENERATED' 

MEXIT 

MNOTE 1,' OPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED* 

MEXIT 

MNOTE 1,* IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED* 

MEXIT 

MNOTE 1, « IMPROPER OPERAND LENGTHS, NO STATEMENTS GENERATED' 

MEND 

MAIN ROUTINE 

CSECT 

BALR R13,0 ESTABLISH ADDRESSABILITY OF PROGRAM 

USING ♦,R13 AND TELL THE ASSEMBLER 

LM R5,R7,=A( LIST AREA, 16, LISTEND) LOAD LIST AREA PARAMETERS 

USING LIST,R5 ItEGISTER 5 POINTS TO THE LIST 

BAL RIU, SEARCH FIND LIST ENTRY IN TABLE 

TM SWITCH, NONE CHECK TO SEE IF NAME WAS FOUND 

BO NOTTHERE BRANCH IF NOT 

USING TABLE, Rl REGISTER 1 NOW POINTS TO TABLE ENTRY 



MOVE TSWITCH , LSWITCH 

NEXT STATEMENT GENERATED FOR MOVE MACRO 

MVC TSWITCH, LSWITCH 





MOVE 


TNUMBER,LNUMBER 


+ 


NEXT 


STATEMENT GENERATED 




MVC 


TNUMBER, LNUMBER 




MOVE 


TADDRESS, L ADDRESS 


♦ 


NEXT 


TWO STATEMENTS GENE 




L 


2, L ADDRESS 




ST 


2, TADDRESS 




BXLE 


R5,R6,MORE 




STOP 




NOTTHERE 


01 


LSWITCH, NONE 




BXLE 


R5,R6,MORE 




STOP 




SWITCH 


DS 


X 


NONE 


EQU 


X*80' 


♦ 


BINARY SEARCH ROUTINE 


SEARCH 


NI 


SWITCH, 255-NONE 




LM 


R1,R3,=F»128, 4,128 




LA 


Rl, TABLAREA- 16 (Rl) 


LOOP 


SRL 


R3,l 




CLC 


LNAME,TNAME 




BH 


HIGHER 




BCR 


8,R14 




SR 


R1,R3 




BCT 


R2 , LOOP 




B 


NOTFOUND 


HIGHER 


AR 


R1,R3 




BCT 


R2,L00P 


NOTFOUND 


01 


SWITCH, NONE 


^ 


BR 


R14 


4< 


THIS 


IS THE TABLE 


* 


DS 


OD 


TABLAREA 


DC 


XLS « • 




DC 


CL8' ALPHA* 




DC 


XLS • • 




DC 


CLS'BETA' 




DC 


XLS • ' 




DC 


CL8 'DELTA' 



MOVE FUNCTIONS 



FROM LIST ENTRY 



TO TABLE ENTRY 



LOOP THROUGH THE LIST 

END OF PROGRAM, USER LIBRARY MACRO 

TURN ON SWITCH IN LIST ENTRY 

LOOP THROUGH THE LIST 

END OF PROGRAM, USER LIBRARY MACRO 



TURN OFF NOT FOUND SWITCH 
' LOAD TABLE PARAMETERS 

GET ADDRESS OF MIDDLE ENTRY 
DIVIDE INCREMENT BY 2 
COMPARE LIST ENTRY WITH TABLE ENTRY 

BRANCH IF SHOULD RE HIGHER IN TABLE 
EXIT IF FOUND 
OTHERWISE IT IS LOWER IN THE TABLE X 

SO SUBTRACT INCREMENT 
LOOP U TIMES 

ARGUMENT IS NOT IN THE TABLE 
ADD INCREMENT 
LOOP 4 TIMES 

TURN ON NOT FOUND SWITCH 
EXIT 
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DC 


XLS'O' 


DC 


CLS'EPSILON' 


DC 


XL8'0' 


DC 


CL8 • ETA* 


DC 


XL8*0* 


DC 


CLB 'GAMMA' 


DC 


XLS ' • 


DC 


CL8*I0TA' 


DC 


XLS'O 


DC 


CL8 'KAPPA' 


DC 


XLS'O' 


DC 


CL8 • LAMBDA ' 


DC 


XLS * ' 


DC 


CL8 • MU • 


DC 


XLS'O' 


DC 


CL8 " NU • 


DC 


XLS " ' 


DC 


CLS'OMICRON' 


DC 


XLS'O' 


DC 


CLS'PHI' 


DC 


XLS'-O' 


DC 


CL8 "SIGMA* 


DC 


XLS ' ' 


DC 


CLS'ZETA' 



* 






* 

4i 


THIS 


IS THE LIST 


LISTAREA 


DC 


CL8" LAMBDA' 




DC 


X'OA' 




DC 


FL3«29' 




DC 


A (BEGIN) 




DC 


CLS'ZETA' 




DC 


X'05' 




DC 


FL3'5' 




DC 


A (LOOP) 




DC 


CLS'THETA 




DC 


X'02' 




DC 


FL3'45' 




DC 


A(BEGIN) 




DC 


CLS'TAU' 




DC 


X'OO' 




DC 


FL3'0' 




DC 


A(l) 




DC 


CLS'LIST' 




DC 


X'lF* 




DC 


FL3'U56' 




DC 


A(0) 


LISTEND 


DC 


CL8 'ALPHA' 




DC 


X'OO' 




DC 


FL3'1' 


% 


DC 


A(123) 




THESE 


ARE THE SYM 


Rl 


EQU 


1 


R2 


EQU 


2 


R3 


EQU 


3 


R5 


EQU 


5 


R6 


EQU 


6 


R7 


EQU 


7 


R13 


EQU 


13 


R14 


EQU 


m 


+ 


THIS 


IS THE FORMA 


LIST 


DSECT 




LNAME 


DS 


CL8 


LSWITCH 


DS 


C 



Appendix I 133 



LNIJMBER 


DS FL3 


LADDRESS 


DS F 




THIS IS THE 


TABLE 


DSECT 


TNUMBER 


DS FL3 


TSWITCH 


DS C 


TADDRESS 


DS F 


TNAME 


DS CL8 




END BEGIN 



FORMAT DEFINITION OF TABLE ENTRIES 



134 



APPENDIX J: ASSEMBLER LANGUAGES — FEATURES COMPARISON CHART 



Features not shown below are common to all assemblers. In the chart: 
Dash = Not allowed. 
X = As defined in Operating System/360 Assembler Language Manual, 



Feature 


Model 20 

Basic 

Assembler 


Basic 

Programming 

Support/360: 

Basic 

Assembler 


7090/7094 
Support 
Package 
Assembler 


BPS 8K Tape, 
BOS 8K Disk 
Assemblers 


BOS 16K 

Disk/Tape 

Assembler 


OS/360 
Assembler 


No. of Continuation Cards/Statement 
(exclusive of macro-instructions) 











1 


1 


2 


Input Character Code 


EBCDIC 


EBCDIC 


BCD & EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


ELEMENTS: 














Maximum Characters per symbol 


4 


6 


6 


8 


8 


8 


Character self-defining terms 


1 Char, only 


1 Char, only 


X 


X 


X 


X 


Binary self-defining terms 








X 


X 


X 


Length attribute reference 








X 


X 


X 


Literals 








X 


X 


X 


Extended mnemonics 






X 


X 


X 


X 


Maximum Location Counter value 


2l4_, 


216-1 


224.1 


224-1 


224-1 


224-1 


Multiple Control Sections per assembly 








X 


X 


X 


EXPRESSIONS: 














Operators 


+ - 


+ -* 


+ -V 


+ -V 


+ -V 


+ -V 


Number of terms 


3 


3 


16 


3 


8 


16 


Levels of parentheses 








1 


3 


5 


Complex relocctability 








X 


X 


X 


ASSEMBLER INSTRUCTIONS: 














DC and DS 














Expressions allowed as modifiers 










X 


X 


Multiple operands 












X 


Multiple constants in an operand 


- - 


- - 


- - 


Except 
Address 
Consts. 


X 


X 


Bit length specifications 












X 


Scale modifier 








X 


X 


X 


Exponent Modifier 








X 


X 


X 


DC types 


Only 
C, X, 

H, Y 


Except 
B, P, Z 
V, Y, S 


Except 
B, V 


X 


X 


X 


DC duplication factor 


Except Y 


Except A 


X 


Except S 


X 


X 
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Feature 


Model 20 

Basic 

Assembler 


Basic 

Programming 

Support/360: 

Basic 

Assembler 


7090/7094 
Support 
Package 
Assembler 


BPS 8K Tape, 
BOS 8K Disk 
Assemblers 


BOS 16K 

Disk/Tape 

Assemb^er 


OS/360 
Assembler 


DC duplication factor of zero 


Except Y 






Except S 


X 


X 


DC length modifier 


Except 
H, Y 


Except 
H, E, D 


X 


X 


X 


X 


DS types 


Only 
H. C 


OnlyC, 
H, F, D 


OnlyC, 
H, F, D 


X 


X 


X 


DS length modifer 


Only C 


OnlyC 


OnlyC 


X 


X 


X 


DS maximum length modifier 


256 


256 


256 


256 


65,535 


65,535 


DS constant subfield permitted 








X 


X 


X 


COPY 










X 


X 


CSECT 








X 


X 


X 


DSECT 


~ 


~ 


X 


X 


X 


-~ 


ISEQ 








X 


X 


X 


LTORG 








X 


X 


X 


PRINT 








X 


X 


X 


TITLE 






X 


X 


X 


X 


COM 










X 


X 


ICTL 





1 operand 
(lor 25 
only) 


1 operand 


X 


X 


X 


USING 


2 operands 
(operand 1 
relocatable! 
only) 


2 operands 
(operand 1 
relocatable 
only) 


2-17 operands 
(operand 1 
relocatable 
only) 


6 operands 


X 


X 


DROP 


1 operand 
only 


1 operand 
only 


X 


5 operands 


X 


X 


CCW 




operand 2 

(relocatable 

only) 


X 


X 


X 


X 


ORG 


no blank 
operand 


no blank 
operand 


no blank 
operand 


X 


X 


X 


ENTRY 


1 operand 
only 


1 operand 
only 


1 operand 
only 


1 operand 
only 


X 


X 


EXTRN 


1 operand 
only 


1 operand 
only (max 14) 


1 operand 
only 


1 operand 
only 


X 


X 


CNOP 


-- 


2 decimal 
digits 


2 decimal 
digits 


2 decimal 
digits 


X 


X 


PUNCH 


-- 


-- 


-- 


X 


X 


X 


REPRO 


-- 


-- 


-- 


X 


X 


X 


Macro Instructions 


S/360 
Model 20 
IOCS only 


— 


~ ~ 


X 


X 


X 
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BPS 8K Tape, 


BOS 16K 


OS/360 
Assembler 


Macro Facility Features 


BOS 8K Disk 
Assemblers 


Disk/Tape 
Assembler 


Operand Sublists 




X 


,X 


Attributes of macro-instruction operands inside macro definitions and symbols used in 


- - 


X 


K 


conditional assembly instructions outside macro definitions. 








Subscripted SET symbols 




X 


X 


Maximum number of operands 


49 


100 


200 


Conditional assembly instructions outside macro definitions 




X 


X 


Maximum number of SET symbols 








global SETA 


16 


* 


* 


glolial SETB 


128 


* 


* 


global SETC 


16 


* 


* 


local SETA 


16 


* 


* 


local SETB 


128 


* 


* 


local SETC 





* 


* 


* The number of SET symbols permitted by the Basic Operating System/360 Assembler (16K Disk/Tape) and the Operating 


System/360 Assembler is variable, dependent upon available main storage. 






Note: The maximum size of a character expression is 127 in BOS (16K) and 255 characters in OS. 
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INDEX 



&SYS „ restrictions on use^ 63, 75, 90 
&SYSECT (see Current control section nane) 
&SYSLIST (see Macro-instruction operand] 
&SYSNDX (see Macro-instruction index) 
7090/7094 Support Package Assembler, 8, 135 
Absolute terms , 15 
ACTR instruction 84 
Address constants, 47 

A- type, 4 7 

Complex relocatable expressions, 47 

Literals not allowed, 2 

S-type, 4 8 

V-type, 4 8 

Y~type, 47 
Address specification, 34 
Addressing 2 4 

Dummy sections, 29 

Explicit, 24 

External control sections, 32 

Implied, 24 

Relative, 26 
AGO instruction 8 4 

Example, 84 

Form of, 84 

Inside macro-definitions, 84 

Operand field of, 84 

Outside macro-definitions, 84 

Sequence symbol in, 84 

Use of, 84 
AIF instruction 83 

Example of, 83 

Form of, 83 

Inside macro-definitions. 

Invalid operand fields of. 

Logical expression in, 83 

Operand field of, 83 

Outside macro-definitions. 

Sequence symbols in, 83 

Use of, 83 

Valid operand fields of, 
Alignm.ent, boundary 

CNOP instruction for, 55 

Machine instruction, 33 
Ampersands in 

Character expressions, 79 

Macro-instruction operands , 

r^NOTE instruction, 89 

Symbolic parameters, 63 

Variable symbols, 59 
ANOP instruction 85 

Example of, 85 

Form of, 85 

Sequence symbol in, 85 

Use of, 85 
Apostrophes in 

Character expressions, 78 

Macro-instruction operands , 

MJSIOTE instruction, 89 
Arithmetic expressions 

Arithmetic relations, 81 

Evaluation procedure , 76 

Invalid examples of, 76 

Operand sublists, 77 

Operators allov?ed, 76 

Parenthesized terms in 76 



83 
83 



83 



83 



66 



66 



evaluation of, 76 
examples of, 76 

SETA instruction, 75 

SETB instruction, 81 

Substring notation, 79 

Term.s allowed, 76 

Valid examples of, 76 
Arithmetic relations, 81 
Arithmetic variable, 93 
Assembler instructions 

Statement, 38 

Table, 119 
Assembler language 8 

Basic Programming Support, 8, 135 

Comparison chart, 135 

Macro facilities, relation to, 58 

Statement format, 13 

Structure, 15, 16 
Assembler program 

Basic functions, 9 

Output, 2 7 
Assembly, terminating an, 5 7 
Assembly no operation (see ANOP 

instruction) 
Attributes 71 

How referred to, 72 

Inner macro-instruction operands , 

Kinds of, 71 

Notations, 71 

Operand sublists, 72 

Outer macro-instruction operands. 

Summary chart of, 12 5 

Use of, 71 

(see also specific attributes) 



72 



72 



Basic Programming Support Assembler, 
Base registers 

Address calculation, 9, 32, 34 

DROP instructions, 2 4 

Loading of, 24 

USING instructions, 24 
Binary constant, 4 4 
Binary self-defining term, 19 
Binary variable, 93 
Blanks 

Logical expressions, 81 

Macro-instruction operands, 6 7 

CGW instruction, 50 

Channel command word, defining, 50 

Character codes, 100 

Character constant, 42 

Character expressions, 78 

Ampersands in, 79 

Character relations, 81 

Examples of, 78 

Periods and, 78 

Apostrophes in, 78 

SETB insturctions , 81 

SETC instructions, 78 
Character relations , 81 
Character self-defining term, 19 
Character set, 15, 100 
Character variable, 9 3 



8, 135 
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CNOP instruction, 55 

Coding form, 12 

COM instruction, 30 

Commas, macro-instruction operands, 6 7 

Comments statements 

Examples of, 14, 65 

Model statements, 65 

Not generated, 65 
Comparison chart, 135 
Compatibility 

Assembler language, 7 

Macro-definitions, 99 
Complex relocatable expressions, 47 
Concatenation 

Character expressions, 78, 79 

Defined, 64 

Examples of, 64 

Substring notations , 79 
Conditional assembly elements, summciry 

charts of, 87, 124 
Conditional assembly instructions 

How to write, 70 

Summary of, 87 

Use of, 70 

(see also specific instructions) 
Conditional branch (see AIF instruction) 
Constants (see also specific types) 

Defining (see DC instructions) 

Summary of, 122 
Continuation lines, 11 
Control dictionary, 27 
Conditional branch instruction, 36 

Operand format, 3 7 
Control section location assignment, 2i 
Control sections 

Blank common, 30 

CSECT instruction, 2 8 

Defined, 27 

First control section, properties of 
28 

START instruction, 2 8 

Unnamed, 29 
COPY instruction, 57 
COPY statements in macro-definitions 

Form of, 65 

Model statements, contrasted, 65 

Operand field of, 65 

Use of, 65 
Count attribute 

Defined, 73 

Notation, 71 

Operand sublists, 73 

Use of, 73 

Variable symbols, 73 
CSECT instruction, symbol in, length 

attribute of, 2 8 
Current control section name (&SYSECT) 

Affected by CSECT, DSECT, START, 95 

Example of, 95 

Use of, 95 

Data definition instructions, 39 

Channel command words, 50 

Constants, 39 
Storages, 4 8 
DC instruction, 39 

Duplication factor operand subfield. 

Operand subfield Modifiers, 40 



Type operand subfield, 40 
Length modifier, 40 
Scale modifier, 41 
Exponent modifier, 42 

Constant operand subfield, 42 
Address-constants (see A.ddress 
constants) 

Binary constant, 44 

Character constant, 42 

Decimal-constants, 46 

Fixed-point constants, 44 

Floating-point constants, 45 

Hexadecimal constant, 43 

Type codes for, 41 
Decimal constants, 46 

Length modifier, 46 

Length, maximum, 46 

Packed, 4 5 

Zoned, 45 
Decimal field, integer attribute of, 74 
Decimal self-defining terms, 78 
Defining constants (see DC instruction) 
Defining storage (see DC instruction, 

DS instruction) 
Defining symbols, 17, 70 
Dimension, subscripted SET sym±)ols , 9 3 
Displacements, 34 
Double-shift instruction, 33 
DROP instruction, 25, 33 
DS instruction, 4 8 

Defining areas, 49 

Forcing alignment, 49 
DSECT instruction, 29 

Dummy section location assignment, 29, 31 
Duplication factor, 40 

Forcing aligninent, 49 

Effective address, length, 35 

EJECT instruction, 51 

END instruction, 5 7 

ENTRY instruction, 31 

Entry point symbol, identification of, 31 

EQU instruction, 38 

Equal signs, as macro-instruction operands, 

66 
Error message (see MNOTE instruction) 
Explicit addressing, 24, 34 

Length, 34 
Exponent modifiers, 42 
Expressions, 21, 31 

Absolute, 34 

Evaluation, 2 2 

Relocatable, 34 

Surrmary chart of, 125 
Extended mnemonic codes , 36 

Operand format, 37 

Table, 110 
External control section, addressing of, 

31 
External symbol, identification of, 31 
EXTRN instruction, 31 



40 



First control section. 
Fixed-point constants , 

Format, 44 

Positioning of, 44 

Scaling, 44 



28 

44 
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Vcilues, minimum and maximum, 45 
Fixed-point field, integer attribute of, 

74 
Floating-point constants, 45 

Alignment, 46 

Format, 45 

Scale modifiers, 45 
Floating-point field, integer attribute 

of, 74 
Format control, input, 53 

GBLA instruction 

Form of, 90 

Inside macro-definitions, 90 

Outside, macro-definitions, 90 

Use of, 9 
GBLB instruction 

Form of, 90 

Inside macro-definitions, 90 

Outside macro-definitions, 90 

Use of, 90 
GBLC instruction 

Form of, 90 

Inside macro-definitions, 90 

Outside, macro-definitions, 90 

Use of, 90 
General register zero, base register 

usage, 2 5 
Generated statements, examples of, 64 
Global SET symbols 

Defining, 90 

Examples of, 90, 92 

Local SET symbols, compared, 89 

Using, 90 
Global variable symbols 

Types of, 89 
(see also global SET symbols, sub- 

sciripted SET syiTibols) 

Hexadejcimal constants, 43 
Hexadecimal-decimal conversion chart, 

100 
Hexadecimal self-defining terms, 18 

I' (see Integer attribute) 
ICTL instruction, 52 
Identification-sequence field, 14 
Identifying blank common control section, 

30 
Identifying assembly output, 51 
Identify dummy section, 29 
Implieid addressing, 24, 34 

Length, 34 
Implied length specification, 34 
Inner macro-instruction 

Defined, 68 

Example of, 6 9 

Symbolic parameters in, 68 
Instruction alignment, 33 
Integer attribute 

Decimal fields, 74 

Examples of, 74 

Fixed-point fields, 74 

Floating-point fields, 74 

How to compute, 74 

Notation, 71 

Restrictions on use, 74 



Use of, 74 
ISEQ instruction. 
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K' (see Count attribute) 
Keyword 

Defined, 96 

Keyword macro-instruction, 9 6 

Symbolic parameter and, 96 
Keyword, inner macro-instructions used 

in, 9 7 
Keyword macro-definition 

Positional macro-definitions, compared, 

96 

Use, 9 6 
Keyword macro-instruction 

Example of, 9 7 

Format of, 96 

Keywords in, 9 6 

Operands , 58,96 

Invalid examples, 97 

Valid examples, 9 7 

Operand sublists in, 97 

Keyword prototype statement 

Examples of, 96 

Format of, 96 

Operands , 96 

Invalid examples, 96 
Valid examples, 96 

Standard values, 96 

L' (see Length attribute) 
LCLA instruction 

Form of, 75 

Use of, 75 
LCLB instruction 

Form, of, 75 

Use of, 75 
LCLC instruction 

Form, of, 75 

Use of, 75 
Lengths explicit and implied, 34, 35 
Length attribute 

Defined, 34, 73 

Examples, 73 

iJotation, 71 

Restrictions on use, 73 

Symbols , 17,73 

Use of, 7 3 
Length modifier, 40 

Length subfield, 33 
Level of parentheses, 22 
Library, copying coding form, 5 7 
Linkage symbols (see also ENTRY instruc- 
tion, EXTRN instructions) 

Entry point symbol, 31 

External symbol, 31 

Linkage editor, and 
use of, 31 
Listing, spacing, 52 
Listing control instructions, 52 
Literal pools, 20, 54 
Literals , 20 

Character, 34 

DC instruction, used in, 20 

Duplicate, 21 

Form.at , 2 

Literal pool, beginning, 55 
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Literal pools, multiple, 21 
Local SET symbols 

Defining, 90 

Examples of, 90-92 

Global SET symbols , compared 89 

Using, 90 
Local variable symbols 

Types of, 89 

(see also local SET symbols) 

(see also subscripted SET symbols) 
Location counter 38, 42, 48 

Predefined symbols, 19 

References to, 19 

Setting, 54 
Logical expressions 

AIF instructions, 83 

Arithmetic relations 81 

Blanks in, 81 

Character relations 81 

Evaluation of, 82 

Invalid examples of 82 

Logical operators in, 81 

Parenthesized term^s in 
Evaluation of, 82 
Examples of, 82 

Relation operators in, 81 

SETB instructions, 81 

Terms allowed in, 81 

Valid examples of, 81 
LTORG instruction, 55 

Machine features required, 7 
Machine-instructions, 33 

Alignment and checking, 3 3 

Literals, limits on, 20 

Mnemonic operation codes, 35 

Operand fields and subfields, 33 

Symbolic operand f orm.ats , 35 
Machine-instruction mnemonic codes, 35 

Alphabetical listing, 110 
MACRO 

Form of, 61 

Use, 61 
Macro-def inition 

Compatibility, 99 

Defined, 61 

Example of, 6 3 

How to prepare, 61 

Keyword (see Keyword macro-definition) 

Mixed-m^ode (see Mixed-mode m.acro- 
def inition) 

Placem.ent in source program., 61 

Use, 61 
Macro-definition exit (see MEXIT instruc- 
tion) 
Machine-instruction examples and format 

RR , 33, 35 

RX, 33, 36 

RS, 33, 36 

SI, 33, 36 

SS, 33, 36 

Suxranary table, 10 8 
Macro-definition header statement (see 

MACRO) 
Macro-definition trailer statement (see 

MEND) 
Macro facility 

Additional features 88 



Comparison chart 13 8 

Relation to assembler language 5 8 

Summary 87, 12 3 
Macro-instruction 

Defined, 5 8 

Example of, 6 7 

Form of, 66 

How to write, 66 

Levels of, 69 

Mnemonic operation code. 66 

Name entry of, 6 6 

Omitted operands, 6 7 
Example of, 6 7 

Operand entry of, 66 

Operands 

Ampersands, 66 
Blanks, 6 7 
Commas , 6 7 
Equal signs, 66 
Paired parentheses, 66 
Paired apostrophes, 66 

Operand sublists, 67 

Operation entry of, 66 

Statement form, 6 7 

Types of, 58 

Used as model statement, 6 8 
Macro-instruction index (&SYSNDX) 

AIF instruction, 9 3 

Arithmetic expressions, 93 

Character relation, 9 3 

Examtple, 9 4 

MNOTE instruction, 9 3 

SETB instruction, 9 3 

SETC instruction, 9 3 

Use of, 93 
Macro-instruction operand (&SYSLIST) 

Attributes of, 95 

Use of, 95 

(see also symbolic parameters) 
Macro-instruction prototype statement 

(see Prototype statement) 
Macro-instruction statement (see Macro- 
instruction) 
MEND 

Form of, 61 

MEXIT instruction, contrasted, 88 

Use of, 61 
MEXIT instruction 

Example of, 8 8 

Form of, 8 8 

MEIND, contrasted, 88 

Use of, 88 
Mixed-mode macro-definitions 

Positional m.acro-def initions , 
contrasted, 9 8 

Use, 98 
Mixed-mode macro-instruction 

Exam.ple of, 9 8 

Form of, 9 8 

Operand field of, 58, 98 
Mixed-mode prototype statement 

Example of, 9 8 

Form, of, 9 8 

Operands of, 9 8 
Mnemonic operation codes , 35 

Extended, 37 

Machine-instruction, 35 

Macro-instruction, 61 
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MNOTE instruction 

Ainpersands in, 88 
Error message, 88 
Example of, 88 
Operand entry of , 
Apostrophes in, 88 
Severity code, 88 
Use of, 88 

Model statements 

Comments field of. 
Comments statements, 
Defined, 62 
Name field of, 62 
Operation field of. 
Operand field of, 
Use of , 62 



62 



65 



62 



62 



N' (see Number attribute) 
Name entries , 13 
Number attribute 

Defined, 73 

Example of, 74 

Notation, 73 

Operand sublist, 73 

Operands 

Entries , 13 

Fields, 33 

Sub fie Ids, 33, 3 4 

Symbolic, 31, 33, 35 
Operemd Sublist 

Alternate statement form, 6 7 

Defined, 6 7 

Example of, 68 

Use of, 6 7 
Ope rait ion field, 3 3 
Ordinary symbol, 17 
ORG instruction, 5 4 
Outer macro-instruction defined, 68 

Paire;d parentheses, 66 
Paired apostrophes, 66 
Parentheses in 

Arithmetic expressions, 76 

Logical expressions, 82 

Macro-instruction operands, 66 

Operand fields and subfields, 34 

Paired, 66 
Period in 

Character expressions, 78 

Coimnents statements, 65 

Concatenation, 65 

Sequence symbols, 74 
Positional macro-definition (see Macro- 
definition) 
Positional macro-instruction (see Macro- 
definition) 
Positional macro-instruction (see Macro- 
instruction) 58 
Previously defined symbols, 18 
PRINT instruction, 52 
Program control instructions, 5 3 
Program listings, 10 
Program sectioning and linking, 2 4 
Prototype statement 

Example of, 62 

Form of, 61 

Keyword (see Keyword prototype state- 
ment) 



Mixed-mode (see Mixed-mode prototype 

statement) 
Name entry of, 61 
Operand entry of, 61 
Operation entry of, 61 
Statement form, 61 
Symbolic parameters in, 61 
Use of, 61 
PUNCH instruction, 54 

Relocatability , 15, 10 

Attributes, 31, 17 

Program, general register zero, 25 
Relocatable expressions, 23, 33 

In USING instructions, 25 
Relocatable symbols, 17 
Relocatable terms, 15 

Pairing of, 22 

In relocatable expressions, 23 
Relative addressing, 26 
REPRO instruction, 5 4 
RR machine-instruction format, 33 

Length attribute, 33 

Symbolic operands , 35 
RS machine-instruction format, 33 

Address specification, 34 

Length attribute, 33 

Symbolic operands , 35 
RX machine-instruction format, 33 

Address specification, 34 

Length attribute, 3 3 

Symbolic operands , 35 

S' (see Scaling attribute) 
Sample program., 131 
Scale modifier 

Fixed-point constants, 41 

Floating-point constants, 41 
Scaling attribute 

Decimal fields, 73 

Defined, 73 

Examples of, 73 

Fixed-point fields , 73 

Floating-point fields, 73 

Notation, 91 

Restrictions on use, 73 

Symbols, 73 

Use of, 73 
Self-defining terms, 18 

(see also specific terms) 
Sequence checking, 53 
Sequence symbols, 17, 74 

AGO instruction, 84 

AIF instruction, 83 

ANOP instruction, 85 

How to write, 74 

Invalid examples of, 75 

Macro instruction, 74 

Use of, 74 

Valid examples of, 75 
Set symbols 

Assigning values to, 70 

Defining, 70 

Symbolic parameters, contrasted, 70 

Use, 70 

(see also local SET symbols) 

(see also global SET symbols) 

(see also subscripted SET symbols) 
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SET variable, 92 
SETA instruction 

Examples of, 76, 77 

Form of, 75 

Operand entry of, 75 

Evaluation procedure, 76 
Operators allowed, 76 
Parenthesized terms, 76 
Terms allowed, 76 
Valid examples of, 76 

Operand sublist, 77 
Example, 77 
SETB instruction 

Example of, 82 

Form of, 81 

Logical expression in, 81 
Arithmetic relations, 81 
Blanks in, 81 
Character relations, 81 
Evaluation of, 82 
Operators allowed, 81 
Terms allowed, 81 

Operand entry of, 81 

Invalid examples of, 82 
Valid examples of, 82 
SETC instruction 

Apostrophes, 78 

Character expressions in, 78 
Ampersands, 79 
Periods, 78 

Concatenation in 

Character expressions, 79 
Substring notations , 79 

Examples of, 78-81 

Form of, 79 

Operand entry of, 78 

Substring notations in, 79 

Arithmetic expressions in, 79 
Character expressions in, 79 
Invalid examples of, 79 
Valid examples of, 79 

Type attribute in, 7 8 
Example of, 78 
SETA symbol 

AIF instruction, 76 

Arithmetic relations, 81 

Assigning values to, 70 

Defining, 70 

SETA instruction, 76 

SETB instruction, 76 

SETC instruction, 81 

Using, 76 
SETB symbol 

AIF instruction, 82 

Assigning values to, 70 

Defining, 70 

SETA instruction, 82 

SETB instruction, 82 

SETC instruction, 82 

Using, 82 
SETC symbol 

Assinging values to, 70 

Defining, 65 

SETA instruction, 81 

Using, 80 
Severity code in MNOTE instruction, 
SI machine-instruction format, 39 

Address specification, 34 
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Length attribute, 33 

Symbolic operands, 35 
Source statement library defined, 59 
SPACE instruction, 52 
SS machine-instruction form.at, 33 

Address specification, 34 

Length attribute, 33 

Length field, 34 

Symbolic operands, 35 
START instruction 

Positioning of, 27 

Unnamed control sections, 2 8 
Statements, 11, 13 

Boundaries , 11 

Examples , 13 

Macro-instructions, 66 

Prototype, 61 

Summary of, 121 
Storage, defining (see DS instruction) 
S-type address constant 4 8 
Sublist (see Operand sublist) 
Subscripted SET symbols 

Defining, 92 
Examples, 9 3 

Dimension of, 93 

How to write, 9 2 

Invalid examples of, 9 2 

Subscript of, 93 

Using, 9 3 

Examples, 9 3 

Valid examples of, 92 
Substring notation 

Arithmetic expressions in, 79 

Character expression in, 79 

How to write, 79 

Invalid example of, 79 

SETB instruction, 81 

SETC instruction, 79 

Valid examples of, 79 
Symbol definition, EQU instruction for. 
Symbols 

Defining, 17 

Length attributes, 33 
Referring to, 21 

Length, maximum, 18 

Previously defined, 18 

Restrictions, 18 

Symbol table capacity, 12 7 

Types of, 17 

Value attributes, 33 
Symbolic linkages, 31 
Symbolic operand formats, 35 
Symbolic parameter 

Comments field, 6 3 

Concatenation of, 6 4 

Defined, 63 

How to write, 6 3 

Invalid examples of, 6 3 

Model statements, 6 3 

Prototype statement, 62 

Replaced by, 6 3 

Valid example of, 6 3 
System variable symbols 

Assigned values by assembler, 93 

Defined, 93 

(see also specific system variable 
symbols) 
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T' (see Type attribute) 

Tables, internal, capacity of, 127 

Te rms 

Expressions composed of, 15 

Pairing of, 22 
TITLE instruction, 51 
Type attribute 

Defined, 72 

Literals , 72 

Macro-instruction operands, 72 

Notation, 71 

SETB instruction, 82 

SETC instruction, 78 

Use, 72 



USING instruction, 24, 33 

Value attribute, 17 
Variable symbols, 17 

Assigning values to, 59 

Defined, 59 

How to write, 59 

Summary chart of, 126 

Types of, 59 

Use, 59 

(see also specific variable symbols) 
V-type address constant, 48 

XFR instruction, 8 



Unconditional branch (see AGO instruction) 
Unnamed control section 2 8 



Y-type address constant. 
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